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PREFACE 



The System Productivity Facility (SPF) is a program product that 
assists in program development. It is designed to take advantage 
of the characteristics of IBM 3270 display terminals* and to 
increase programmer productivity in an interactive environment. 

The System Productivity Facility replaces the previous Structured 
Programming Facility program products (SPF/TSO and SPF/CMS). It 
includes significant new functions that support the development, 
testing* and execution of interactive applications. 

SPF consists of two major components: the dialog manager and the 
program development facility. The dialog manager provides con- 
trol and services for running interactive applications. The pro- 
gram development facility provides the previous SPF functions. 

This manual contains detailed information on how to use the SPF 
program development facility under VM/CMS. It is intended for use 
by an application or systems programmer, engaged in program 
development, who is familiar with the VM environment. 

The first three chapters of this manual contain: 

Summary of Amendments - A summary of changes and enhancements 
to the SPF program development facility. 

Introduction - A brief description of the purpose of the SPF 
program development facility. 

General Description - A description of features that are com- 
mon across the various processing options. 

The next several chapters provide detailed user information for 
each function, as follows: 



Invocation and Termination 
Member List Commands 
SPF Parms (Option 0) 
Browse (Option 1) 
Edit (Option 2) 
Utilities (Option 3) 



Foreground (Option 4) 
Batch (Option 5) 
Command (Option 6) 
Support (Option 7) 
Tutorial (Option T) 



This manual also includes several appendixes containing a sample 
problem, description of listing formats, command and quick refei — 
ence summaries, and differences in SPF usage in the MVS and VM 
envi ronments. 



SPF COMMAND FORMATS 



In this document, the following notation conventions are used to 
describe SPF command formats: 

• Command verbs and keywords, which must be typed exactly as 
shown, are represented with uppercase characters. 

• Substi tutable operands are represented with lowercase charac- 
ters. 

• Optional parameters are enclosed in brackets, "[" and "]". 

• A choice of parameters is indicated with slashes. 

• Default parameters are underscored. 

Example: CAPS [ON/OFF] 

The operand is optional. Either ON or OFF may be typed. If the 
operand is omitted, ON is the default. 
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RELATED DOCUMENTS 



SPF Dialog Management Services (SC34-2036) - Provides a 
detailed description of the new SPF services and related 
information required to develop an interactive application 
that runs under SPF. Applies to both the MVS/TSO and VM/CMS 
environments. 

SPF-VM General Information (GC34-2046) - Provides an overview 
and functional description of SPF in the VM/CMS environment. 

SPF-MVS General Information (GC34-2039) - Provides an over- 
view and functional description of SPF in the MVS/TSO envi- 
ronment. 

SPF-MVS Program Reference (SC34-2038) - Provides detailed 
information on how to use the SPF program development faci 1 i - 
ty in the MVS/TSO environment. 
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SUMMARY OF AMENDMENTS 

|>, Most of the changes and new capability in SPF are in the dialog 

p/ manager. The program development facility is the same as the pre- 

vious SPF products* except for the following: 

• Support for IBM 3278 Model 5 Terminals. On a Model 5* infoi — 
mation is normally displayed in "default" mode (24 lines by 80 
columns) with the same size characters as other models. 
Browse and edit data that is wider than 80 characters is dis- 
played with the smaller "native" mode characters (up to 132 
per line). Transition between the two modes is handled auto- 
matically. However, the user can force SPF to remain in one 
mode or the other via option 0.1. 

• New Command Name. SPF is now invoked with the "ISPF" command. 
This allows concurrent use of the new and previous SPF pro- 
ducts during the transition period. Your installation may 
assign "SPF" as an alias of "ISPF" if desired. 

• Initial Option on ISPF Command. An initial option (e.g.* "2" 
or "3.1") may be specified as a parameter on the "ISPF" com- 
mand to bypass initial display of the primary option menu. 

• Input Field Padding. Nulls are now used as the default pad- 
ding for menu input fields and command lines to enable use of 
the INSERT key. The user may change the pad character to 
blanks via option 0.1. 

• Scroll Amount Field. The current scroll amount is now a 
"remembered" parameter (during sessions and across sessions). 
Three different scroll amounts are saved — one for browse* 
one for edit* and one for member lists. 

• Edit NUMBER and RENUM Commands. These commands now allow an 
additional DISPLAY parameter to specify whether sequence num- 

\ bers (in the data) are to be displayed. 

/ 

• Transmission of SPF Libraries. The spool and reader utili- 
ties (options 3.6 and 3.7) now support transmission of an 
entire SPF library (including statistics) to another CMS user 
on the same or different VM system. 

• Support for PASCAL/VS Compiler. The new PASCAL/VS compiler 
is supported under foreground and batch (options 4 and 5). 

• New Option 7. A new primary option, option 7* provides sup- 
port for testing of interactive applications designed to run 
under the SPF dialog manager* and for converting menus and 
messages to the new SPF formats. The tutorial* which was pre- 
viously option 7, is now option T. 



m 



) 



• Program Function (PF) Key Usage. The following changes have 
been made in PF key usage: 

The default assignment for PF4 is RETURN. This only 
affects new users. The remembered PF assignments in cui — 
rent user profiles are carried forward. 

Under tutorial* the Scroll Down PF key is interpreted to 
mean "skip to next topic." Previously* it had no function 
in tutorial mode. 

Finally, there has been a terminology change to more closely 
reflect general usage. Previously* all SPF screen images were 
called menus. The term menu is now used to mean a display from 
which the user may select options. The term panel is used to mean 
any predefined display image* of which one type is a menu. Other 
types include data entry panels and information (e.g., 
help/tutorial) displays. 
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INTRODUCTION 



The SPF program development facility is designed to increase pro- 
grammer productivity in an interactive environment. It can be 
used either by an individual programmer, or by many programmers 
working together on a project. Significant features include: 

• Support for multilevel programming libraries. Facilitates 
maintenance and tracking of program segments at varying vei — 
sion and modification levels. 

• Full-screen, context editing. Allows additions and changes 
to multiple lines in a single interaction. Simple 
one-character edit commands are used for inserting, deleting, 
duplicating, or rearranging lines of source data. 

• Forward, backward, and sideways scrolling of source data or 
listings, plus the ability to locate information by character 
string or line number. 

• Utilities for specification and maintenance of SPF libraries 
and f i les. 

• Interface to standard language processors (compilers and 
assembler) for execution in the foreground or CMS batch 
machine. 

• Document preparation support. Includes text editing features 
and an interface to the SCRIPT/VS Document Composition Facil- 
ity. 

• Online tutorial for instruction and reference — especially 
valuable for the occasional or novice user. 

The program development facility supports both structured and 
conventional programming techniques. 

Structured programming emphasizes the use of segmentation and 
indentation. A source program normally consists of a large number 
of relatively small segments. The segments are stored as separate 
members of a programming library. Within a segment, source state- 
ments are block-indented under each "IF-THEN-ELSE" or "DO-WHILE" 
to show the control structure. Features which are specifically 
oriented toward structured programming include: 

• Ease of segmentation changes. One segment (member) can easi- 
ly be split into multiple segments, or multiple segments can 
be merged into one. 

• Ease of indentation changes. Single statements or blocks of 
statements can easily be shifted left or right by a specified 
number of column positions. 

• Insert in context. A "DO-END" pair, for example, may be coded 
on consecutive lines, and then space can be opened between the 
two lines to allow insertion of a block of code. 

• Visual verification aids. A block of code may be temporarily 
excluded from display so that the space which it occupies on 
the screen is closed up. This facilitates visual verifica- 
tion of the control structure, particularly when the length 
of a segment exceeds the screen size. 
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GENERAL DESCRIPTION 



Following is a description of features that are common across the 
various processing options of the program development facility. 



DISPLAY FORMAT 






) 



Four basic types of display presentations are used: 

1. Selection Menus - The user selects from a list of options by 
typing a one-character code and pressing the ENTER key. Exam- 
ple: The SPF primary option menu (Figure 1). 

2. Entry Panels - The user supplies parameters by filling in 
labeled fields. In many cases, fields are pre-entered based 
on what the user last entered. Example: The browse entry 
panel (Fi gure 2) . 

3. Member Selection Lists - Displays a list of members in a pro- 
gramming library. The user may select a member by entering a 
one-character code in front of the appropriate member name. 
Figure 3 shows an example of a member list on which the user 
has selected member COINS. 

4. Data Display - Displays source code or output listings. 
Figure 4 shows an example of the browse display. 

All menus and panels &re formatted to fit on a 24 line by 80 char- 
acter screen. On a 3278 Model 3 or 4, scrollable data will occupy 
the full length of the screen (32 or 43 lines). 

On a 3278 Model 5, information is normally displayed in "default" 
mode (24 by 80) with the same size characters as other models. 
Browse and edit data that is wider than 80 characters is displayed 
with the smaller "native" mode characters (up to 132 per line). 
The user may override the automatic switching of modes. 

The first three lines of each display &re formatted as follows: 



li ne 1 
line 2 
line 3 



Title 



Short Message 



Prompt/Input Scroll 



Long Message 



The title area (line 1) identifies the function being performed 
and, where appropriate, the library or file identification* 
member name, version number, and modification level. The short 
message area (line 1) is used to indicate: 

• Current line (browse) and column positions (browse and edit) 

• Successful completion of a processing function 

• Error conditions (accompanied by audible alarm) 

The prompt/input area (line 2) is used to enter an option 
selection or command. In cases where no option selection or com- 
mand is applicable, this area contains a prompt. The scroll area 
(line 2) contains the current scroll amount whenever scrolling is 
applicable. The scroll amount may be overtyped by the user (see 
"Scrolling"). 

The long message area (line 3) is used to display an explanation 
of error conditions upon request (see "Help Information"). 
Normally this line is blank on menus and panels, contains column 
headings on member selection lists, and is treated as part of the 
data area on data displays. 
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SELECT OPTION ===> 



SPF-VM PRIMARY OPTION MENU 






SPF PARMS 


1 


BROWSE 


2 


EDIT 


3 


UTILITIES 


4 


FOREGROUND 


5 


BATCH 


6 


COMMAND 


7 


SUPPORT 


T 


TUTORIAL 


X 


EXIT 



USERID - STEPHENS 
TIME - 12:47 
TERMINAL - 3277 
PF KEYS - 12 



SPECIFY TERMINAL AND SPF PARAMETERS 

DISPLAY SOURCE DATA OR OUTPUT LISTINGS 

CREATE OR CHANGE SOURCE DATA 

PERFORM SPF UTILITY FUNCTIONS 

COMPILE, ASSEMBLE, LOAD, OR TEST 

COMPILE, ASSEMBLE, OR LOAD 

ENTER CMS COMMAND OR EXEC 

TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 

DISPLAY INFORMATION ABOUT SPF 

TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 



PRESS END KEY TO TERMINATE SPF 



Figure 1. Primary Option Menu 



BROWSE - ENTRY PANEL 

ENTER/VERIFY PARAMETERS BELOW: 



SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ===> PLI 
MEMSER ===> 



(BLANK FOR MEMBER SELECTION LIST) 



CMS FILE: 

FILE ID ===> 

MEMBER ===> (FOR MACLIB OR TXTLIB) 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> DEVICE ADDR. ===> 

READ PASSWORD ===> 



LINK ACCESS MODE =-=> 



Figure 2. Browse - Entry Panel 
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} 



BROWSE - SPFDEMO 
COMMAND INPUT === 


.MYLIB.PLI 
























SCROLL == 


=> PAGE 


NAME 


VER.MOD 


CREATED 


LAST MODIFIED 


SIZE 


INIT 


MOD 


ID 


ACCOUNT 


01.00 


79/01/09 


79/01/09 


17:07 


21 


21 





KLEIN 


ACCT1 


01.01 


79/01/09 


79/04/23 


14:52 


99 


193 





KLEIN 


ACCT2 


01.00 


79/01/09 


79/01/09 


17:07 


20 


20 





ORR 


S COINS 


01.04 


79/04/2* 


79/04/24 


16:20 


19 


19 


4 


ORR 


COMPX 


01.00 


79/01/09 


79/01/09 


17:08 


44 


44 





ORR 


COMPY 


01.01 


79/01/14 


79/01/14 


12:30 


13 


13 


1 


ORR 


DCLS 


01.00 


79/04/23 


79/04/23 


15:14 


20 


20 





MOSTON 


LISTNEW 


01.02 


79/04/23 


79/04/23 


15:00 


17 


13 


6 


KLEIN 


MAIN 


01.00 


79/01/09 


79/01/09 


17:08 


4 


4 





MOSTON 


TESTDIR 


01.02 


79/04/23 


79/05/06 


17:04 


30 


43 


10 


MOSTON 


UPDATE 


01.00 


79/01/09 


79/01/09 


17:08 


13 


13 





MOSTON 


**E,ND** 



















Figure 3. Browse - Member Selection List 






BROWSE - SPFDEMO. MYLIB.PLI (COINS) - 01.04 ~ LINE 00000 COLS 001 080 

COMMAND INPUT ===> _ SCROLL ===> PAGE 

********************************* TOP OF DATA **********************-CAPS ON-** 

COINS: 00010001 

PROCEDURE OPTIONS (MAIN); 00020000 

DECLARE 00030000 

COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 00040000 

HALVES FIXED BINARY (31), 00050000 

QUARTERS FIXED BINARY (31), 00060003 

DIMES FIXED BINARY (31), 00070000 

NICKELS FIXED BINARY (31), 00080004 

SYSPRINT FILE STREAM OUTPUT PRINT; 00090000 

DO HALVES = 100 TO BY -50; 00100000 

DO QUARTERS = (100 - HALVES) TO BY -25; 00110000 

DO DIMES = ((100 - HALVES - QUARTERS )/10 )*10 TO BY -10; 00120000 

NICKELS = 100 - HALVES - QUARTERS - DIMES; 00130000 

PUT FILE (SYSPRINT) DATA(COUNT,HALVES,QUARTERS,DIMES,NICKELS);00140000 

COUNT = COUNT +1; 00150000 

END; 00160000 

END; 00170000 

END; 00180000 

END COINS; 00190001 

******************************** BOTTOM OF DATA ********************-CAPS ON-** 






Figure 4. Browse - Data Display 
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SPF LIBRARIES 



An SPF library is a collection of code or data units, called mem- 
bers. Each library generally contains members with the same type 
of information. Figure 5 shows a sample set of five SPF libraries 
which contain Assembler source, COBOL source, TEXT (object) 
modules, test data, and SCRIPT documentation. 



MEMBER 
A 


MEMBER 
A 


MEMBER 
D 


MEMBER 
UK 


MEMBER 
D 


MEMBER 
D 


MEMBER 
B 


MEMBER 
Q 


MEMBER 
F 


MEMBER 
E 


MEMBER 
PQRS 


MEMBER 
C 


• 
• 
• 
• 


MEMBER 
XYZ 


MEMBER 
G 


• 
• 
• 
• 


• 
• 
• 


• 
• 
• 


• 
• 



ASSEMBLE COBOL 



TEXT 



DATA 



SCRIPT 



Figure 5. SPF Library Organization 



SPF libraries are identified by project name, library name, and 
type, where: 

• "project name" is the common identifier for all libraries 
belonging to the same project. 

• "library name" identifies the particular set of libraries, 
such as MASTER, TEST, or ALICE. 

• "type" identifies the type of information in the library, 
such as ASSEMBLE, COBOL, TEXT (object modules), DATA, or 
SCRIPT. Except for TEXT, the SPF type qualifier need not con- 
form to the standard CMS naming conventions. 

Most projects will require a hierarchy of related libraries to 
maintain effective version control over the programming develop- 
ment process and to -reduce contention in library usage. Figure 6 
shows a sample three-level hierarchy for a project, consisting of 
a set of master libraries, a set of test libraries, and three sets 
of development (private) libraries identified by user id. 

New members or members undergoing changes will generally reside 
in the development libraries. A test library may be used to accu- 
mulate members which have been unit tested and are ready for inte- 
gration test. A master library contains fully tested members, 
which may correspond to a previously released version of the pro- 
gram. Typically, a higher degree of control is maintained over 
the higher level libraries than the development libraries. 
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Figure 6. Hierarchy of SPF Libraries 



SPF allows concatenation of up to four SPF libraries during source 
editing, compilation, assembly, or SCRIPT/VS processing (plus 
additional MACLIBs for compilations and assemblies). Generally, 
the lowest level library is concatenated ahead of the next higher 
level library, and so on, in bottom-to-top order. For the hierai — 
chy shown in Figure 6, a typical concatenation sequence might be 
library LARRY, followed by TEST, followed by MASTER. The concat- 
enation applies to libraries of the same type, and is restricted 
to libraries which belong to the same project. 

The purpose of concatenation during editing is to provide down- 
ward copying of a member from a test or master library to a devel- 
opment library. The edited member is saved in the development 
library (the first library in the concatenation sequence), while 
the unchanged version remains in the test or master library. When 
the new version is fully tested, it may be promoted back to a 
higher level library by means of the move/copy utility. 

The purpose of concatenation during language processing is to 
facilitate inclusion of source segments via INCLUDE or COPY 
statements (or SCRIPT "imbed" controls), and to allow debugging 
of new or modified programs without altering the contents of the 
test or master libraries. The output from a compilation or assem- 
bly (object module) is stored in the lowest level TEXT library 
(the first library in the concatenation sequence). 

SPF libraries are maintained internally as CMS files. Each SPF 
library may consist of a set of CMS sequential files, or it may be 
a MACLIB or TXTLIB (for TEXT libraries only). The particular 
organization is designated when the library is specified to SPF 
via the file utility (option 3.2). 
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PARAMETER SPECIFICATION 



Several entry panels require specification of an SPF library or 
CMS file identifier, and (when applicable) a read and/or update 
password. These are described in the following paragraphs. 



Library and File Identification 



To specify a member 

ject i 
of these may co 



of an SPF library, the user must enter a 



cinuci w i ail «*i i J. I ui ci y , liic u ij«=i mu^>v cutci « 

project name, library name, type qualifier, and member name. Each 
of these may contain up to eight alphameric characters, of which 
the first character must be alphabetic. SPF automatically issues 
LINK and ACCESS commands, when required, to access the minidisk on 
which the SPF library resides. 

SPF panels prompt the user for each component of the library iden- 
tification as follows: 



SPF LIBRARY: 
PROJECT ===> 
LIBRARY ===> 

TYPE ===> 
MEMBER ===> 



(BLANK FOR MEMBER SELECTION LIST) 



If the member name is not specified, a member selection list will 
be di splayed. 

When the library identification is displayed on a title line or 
message, the following shorthand notation is used: 

project . 1 i brary . type(member) 

That is, the project name, library name, and type qualifier are 
separated with periods, and the member name is enclosed in paren- 
theses. 

Some panels allow a concatenated sequence of up to four SPF 
libraries. For example: 



SPF LIBRARY: 




PROJECT ===> SAMPLE 




LIBRARY ===> LARRY 


===> TEST ===> MASTER ===> 


TYPE ===> COBOL 




MEMBER ===> 


(BLANK FOR MEMBER SELECTION LIST) 



In this example, three COBOL libraries belonging to project SAM- 
PLE would be concatenated in the following order of search: 

SAMPLE. LARRY. COBOL 
SAMPLE. TEST. COBOL 
SAMPLE. MASTER. COBOL 

CMS files may also be specified on panels, as follows: 



CMS FILE: 




FILE ID ===> 




MEMBER ===> (FOR MACLIB OR TXTLIB) 




IF NOT LINKED, SPECIFY: 




OWNER'S ID ===> DEVICE ADDR. ===> 


LINK ACCESS MODE ===> 



The CMS file id is entered according to normal CMS conventions, 
i.e.: filename, filetype, and (optionally) filemode, separated by 
one or more blanks. 
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If both an SPF library and a CMS file id are specified on the same 
panel, the CMS file id is used. In other words, to specify an SPF 
library, the CMS file id must be blank. 

If the CMS file is on a minidisk which is not currently linked and 
accessed, SPF will issue the appropriate LINK and ACCESS com- 
mands, based on user-specified LINK command parameters (owner's 
user id, virtual device number, and link access mode). 

If a filemode is specified as part of the CMS file id, the speci- 
fied filemode letter will be used in issuing the ACCESS command. 
Otherwise, the first available (currently unused) filemode letter 
will be used. Minidisks which are linked and accessed by SPF for 
the user will remain linked and accessed only as long as they are 
being used by a given function (e.g., edit). 



Passwords 



SPF supports the use of VM password protection for read-only or 
read/write minidisks. Passwords may be specified as follows: 



READ PASSWORD ===> UPDATE PASSWORD ===> 



Non-display input fields are used so that the passwords will not 
appear on the screen. 

If the minidisk containing the SPF library or CMS file is password 
protected, the user must enter one or both passwords. Only the 
read password need be supplied for read-only functions (e.g., 
browse). The update password must be supplied for functions that 
cause data to be written to the minidisk (e.g., edit). In edit, 
if concatenated SPF libraries are specified that reside on two or 
more minidisks, the first library is linked for update and the 
higher level libraries are linked read-only. Therefore both a 
read and update password may be required. 

Note ; The "update" password may require either the write (W) or 
multiple write (MW) password depending upon how the SPF library 
was specified (see utility 3.2) or, for a CMS file, depending on 
what was specified on the panel for link access mode. 



USER PROFILES 



# 



SPF "remembers" information on behalf of each user in a user pro- 
file. This allows SPF to prefill panel input fields with the val- 
ues that were last entered by the user on the same (or similar) 
panel. In some cases, default values are provided if the user has 
not specified otherwise. 

Information maintained in a user profile includes: 

Project name, library name(s), type, and password 
Job statement information (for CMS batch submission) 
Defaults for console, log, and list processing 
Terminal characteristics and PF key definitions 
Edit profiles, including mask, tabs, and bounds 
Current scroll amount (browse, edit, and member lists) 
Processing options for each of the language processors 
File specification/information parameters 

This information is automatically maintained from one session to 
another. A new user will have to enter certain information the 
first time it appears. But from that point cfn, the user simply 
verifies the information and makes whatever changes are desired 
before proceeding. 
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PROGRAM ACCESS AND FUNCTION KEYS 

The program access (PA), and program function (PF) keys are used 
to request commonly used operations. Keys that are not needed for 
SPF-defined key operations may be equated to edit and browse pri- 
mary commands, or edit line commands, using the SPF parms option 
(opti on 0.3). 

The default key arrangement for the 3-by-4 key pad (right-hand 
side of the keyboard) is shown in Figure 7. These are PF keys 
1-12 on a 12-key terminal, or keys 13-24 on a 24-key terminal. 

For 24-key terminals, PF keys 1-12 have the same defaults as keys 
13-24. It is strongly recommended that users of 24-key terminals 
continue to use the key pad (13-24) for SPF-defined operations, 
and redefine PF keys 1-12 to edit and browse commands. 



PA1 
ATTENTION 


PA2 
RESHOW 



PF1 / 13 


PF2 / 14 


PF3 / 15 


HELP 


SPLIT 


END 


PF4 / 16 


PF5 / 17 


PF6 / 18 


RETURN 


FIND 


CHANGE 


PF7 / 19 

t 


PF8 / 20 

i 


PF9 / 21 
SWAP 


1 
(UP) 


T 
( DOWN ) 




PF10 / 22 


PF11 / 23 


PF12 / 24 


< 


► 


CURSOR 


(LEFT) 


(RIGHT) 





Figure 7. Default Program Key Arrangement 



The two PA keys are defined as follows. They may not be redefined 
by the user. 

ATTENTION (PAD Causes an immediate return to CP mode. This key 
should not be used, since it bypasses normal SPF 
termination. If it is pressed by mistake, a 
BEGIN command should be entered to resume SPF. 



RESHOW (PA2) 



Redisplays the contents of the screen. May be 
useful if the ERASE or CLEAR key was pressed 
accidently, or if unwanted information has been 
typed but ENTER (or a PF key) has not yet been 
pressed. Note that SPF does not support use of 
the Field Mark character (same key as PA2). 
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The SPF-defined PF key operations are 
Figure 7 for the default key assignments. 



described below. See 



| 



HELP 

SPLIT 

END 

RETURN 



FIND 

CHANGE 

UP 

DOWN 

SWAP 

LEFT 

RIGHT 

CURSOR 



PRINT 



PRINT-HI 



NOP 



Displays additional information about an error message 
or tutorial information about SPF commands and options. 

Causes split screen mode to be entered, or changes the 
location of the split line (see "Split Screen"). 

Terminates the current operation and returns to the 
previous menu. If the primary option menu is displayed, 
this key terminates SPF. 

Causes an immediate return to the primary option menu, 
bypassing any intermediate menus. (Logically equiv- 
alent to repeated use of the End PF key.) May also be 
used to go directly from one option to another, without 
displaying the primary option menu, as follows: In any 
menu or panel input field that is preceded by an arrow 
(===>), enter an equal sign (=) followed by a primary 
option. Then press the Return PF key rather than ENTER. 

Repeats the action of the previous FIND command or the 
FIND part of the most recent CHANGE command (applies to 
browse and edit only). 

Repeats the action of the previous CHANGE command 
(applies to edit only). 

Causes a scroll up (see "Scrolling"). 

Causes a scroll down (see "Scrolling"). 

Moves the cursor to wherever it was previously 
positioned on the other logical screen (see "Split 
Screen") . 

Causes a scroll left (see "Scrolling"). 

Causes a scroll right (see "Scrolling"). 

Moves the cursor to the first input field on line 2 
(normally, the option selection or command input 
field). Pressing this PF key again causes the cursor to 
be moved to the second input field on line 2, if any 
(normally the scroll amount field). 

Causes a "snapshot" of the. screen image to be recorded 
in the SPF list file. 

Same as PRINT except that high intensity characters on 
the screen are printed with overstrikes to simulate the 
dual intensity display. Should not be used if list out- 
put is to be spooled to a printer which does not support 
suppress-space carriage control. 



Causes the PF key to be functi onless. 



The PRINT, PRINT-HI, and NOP functions have no default 
assi gnments. 



PF key 



The only PF key function that is required is the End key. Other 
keys may be assigned to edit and browse commands, or to PRINT, 
PRINT-HI, or NOP. 

Caution on use of 3270 RESET key ; On a 3277 or 3275, when the key- 
board is locked during SPF processing, do not press RESET and 
attempt to enter additional information or use a PF key. Such 
action may produce unpredictable results. 
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SCROLLING 



During edit and browse* the information to be displayed will gen- 
erally exceed the screen size. Scrolling allows the screen "win- 
dow" to be moved up, down, left, or right across the information. 
A member list can also be scrolled up and down, if it exceeds a 
single screen length. 

Four program function (PF) keys are used for scrolling — one for 
each di recti on. Whenever scrolling is allowed, a scroll amount is 
displayed at the top of the screen (line 2). This determines the 
number of lines (or columns) scrolled with each use of a Scroll PF 
key. The user may change the scroll amount by moving the cursor 
o the scroll field and overtyping the displayed amount. Valid 
scroll amounts are: 

A number from 1 to 9999 - specifies the number of lines (up or 
down) or columns (left or right) to be scrolled. 

PAGE - specifies scrolling by one page. 

HALF - specifies scrolling by a half page. 

MAX - specifies scrolling to the top, bottom, left margin, or 
right margin, depending upon which Scroll PF key is used. 

CSR - specifies scrolling based on the current position of the 
cursor. The line or column indicated by the cursor is moved 
to the top, bottom, left margin, or right margin of the 
screen, depending upon which Scroll PF key is used. If the 
cursor is not in the body of the data, or if it is already 
positioned at the top, bottom, left margin, or right margin, a 
full page scroll will occur. 

In edit, left and right scrolling is also affected by the current 
setting of the bounds. See description of BOUNDS command. 

For scrolling purposes, a "page" is defined as the amount of 
information currently visible on the logical screen. In split 
screen mode, for example, a browse display might have 12 lines by 
80 columns of scrollable data. In this case, a scroll amount of 
HALF would move the window up or down by 6 lines, or right or left 
by 40 columns. 

The current scroll amount is saved in the user profile. Three 
different values are saved — one for browse, one for edit, and 
one for member lists. When the user overtypes the scroll amount, 
the new value remains in effect until it is again changed by the 
user. The value MAX is an exception; following a MAX scroll, the 
scroll amount reverts to its previous value. 

Any valid scroll amount can also be entered in the command input 
field and used in conjunction with a Scroll PF key. For example: 



ENTER COMMAND ===> 3 SCROLL ===> HALF 



If a Scroll PF key is pressed, the value in the command area will 
be used, overriding the normal scroll amount, without causing a 
change to the scroll field. This results in a one-time override; 
the value in the command area is blanked out after scrolling 
occurs. 

If some key other than a Scroll PF key is pressed, the value in 
the command area will be interpreted as a command and will proba- 
bly result in an error message. 
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OVERTYPING OF SCROLL AND MULTIPLE CHOICE PARAMETERS 

To reduce keystrokes, the scroll amount field can be changed by 
overtyping the first character(s) only: 

• To change the scroll amount to PAGE, HALF, MAX, or CSR only 
the first character need be overtyped with "P", "H", "M", or 
"C" respectively. 

• In the scroll amount field, any alphabetic characters follow- 
ing a number are ignored. For example "3AGE" is interpreted 
as "3". 

The same rule applies to multiple choice parameters in cases where 
the first letter uniquely defines the option. Examples: 



REPLACE MEMBERS "=> NO 
FILE DISPOSITION ===> OLD 



(YES OR NO) 
(OLD OR MOD) 



To change these options to YES or MOD, only the first character 
need be overtyped with "Y" or "M" respectively. 



SPLIT SCREEN 



Split screen mode allows the user to partition the display screen 
into two logical screens. The top and bottom screens are treated 
as though they were independent terminals. Functions that can be 
performed simultaneously on two separate terminals can be done on 
the top and bottom screens. Functions that are in conflict on two 
separate terminals (editing the same member of an SPF library or 
the same CMS sequential file, or browsing the same CMS file) will 
also be in conflict when simultaneously attempted on the top and 
bottom screens. 

Split screen mode is entered by pressing the Split PF key, but 
first the user moves the cursor to the desired location for the 
split. The line containing the cursor will become the split line 
and will be identified by a row of periods. When the Split PF key 
is pressed, all lines below the cursor are treated as the bottom 
screen. The first display to appear on the bottom screen is the 
primary option menu. An example is shown in Figure 8. 

Note : Since only one logical screen is active at a time, the user 
cannot split the screen while executing a foreground compilation 
or a CMS command. 

The split location may be repositioned at any time by moving the 
cursor to the desired line and pressing the Split PF key again. 
Repositioning may be required to bring an entire panel or tutorial 
page into view. 



In split screen mode, one or the other of the logical screens is 
considered active at any point in time. Any interrupts, such as 




} 
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screen to the other, the cursor movement keys may be used or the 
Swap PF key may be pressed. 

In addition to moving the cursor to the other logical screen, the 
Swap PF key will automatically reposition the split if either log- 
ical screen is less than five lines long. For example, if the 
split occurs at the third line down from the top and the cursor is 
on the bottom screen, pressing the Swap PF key will move the cui — 
sor to the top screen and reposition the split to the third line 
up from the bottom. This allows the use of two screens in 
"flip-flop" mode, with each logical screen consuming nearly all 
lines of the physical screen. 
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BROWSE - SPFDEMO.MYLIB.PLKCOINS) - 01.04 LINE 00000 COLS 001 080 

COMMAND INPUT ===> SCROLL ===> PAGE 

********************************* TOP OF DATA **********************-CAPS ON-** 

COINS: 00010001 

PROCEDURE OPTIONS (MAIN) 5 00020000 

DECLARE 00030000 

COUNT FIXED BINARY (31) AUTOMATIC INIT CD, 00040000 

HALVES FIXED BINARY (31), 00050000 

QUARTERS FIXED BINARY ( 31 ) , 00060003 



SELECT OPTION ===> 



SPF-VM PRIMARY OPTION MENU 






SPF PARMS 


1 


BROWSE 


z 


EDIT 


3 


UTILITIES 


4 


FOREGROUND 


5 


BATCH 


6 


COMMAND 


7 


SUPPORT 


T 


TUTORIAL 


X 


EXIT 



USERID - STEPHENS 
TIME - 12:47 

TERMINAL - 3277 
PF KEYS - 12 



SPECIFY TERMINAL AND SPF PARAMETERS 

DISPLAY SOURCE DATA OR OUTPUT LISTINGS 

CREATE OR CHANGE SOURCE DATA 

PERFORM SPF UTILITY FUNCTIONS 

COMPILE, ASSEMBLE, LOAD, OR TEST 

COMPILE, ASSEMBLE, OR LOAD 

ENTER CMS COMMAND OR EXEC 

TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 

DISPLAY INFORMATION ABOUT SPF 

TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 



PRESS END KEY TO TERMINATE SPF 



Figure 8. Split Screen Example 



Split screen mode is terminated by ending SPF processing on either 
logical screen (i.e., by pressing the End PF key or by entering 
option "X" when the primary option menu is displayed). The 
remaining logical screen i s then expanded to its full size. Split 
screen may also be terminated by typing =X (exit option) in the 
command input area and pressing the Return PF key. 



HELP INFORMATION 



The help function allows the user to obtain additional informa- 
tion about a message that has been displayed in the upper 
right-hand corner of the screen, or general information about an 
SPF command or option. 

If a message is displayed, pressing the Help PF key causes a 
one-line explanation to be displayed. If this explanation is not 
sufficient, the user may obtain further information by pressing 
the Help key again. This causes an entry into the appropriate 
section of the tutorial. If a message is not displayed, the Help 
PF key causes a direct entry into the appropriate section of the 
tutorial . 

Once in the tutorial, the End PF key causes a return to the screen 
that was being viewed when the Help key was originally pressed. 



14 SPF-VM Program Reference 



) 



LIBRARY ACTIVITY STATISTICS 

Under user option* the SPF editor will automatically generate and 
maintain the following activity statistics for each member of an 
SPF library. 

Version Number: Initialized to 1 when the member is created. 

Modification Level: Number of times this version has been 

modified. 

Creation Date: When this version Mas created. 

Date/Time Modified: When this version Mas last modif i ed. 

Current No. Lines: Current size (number of records). 

Initial No. Lines: Initial size of this version. 

No. Modified Lines: Number of lines added or changed since this 

version was created. (Zero for unnumbered 
data.) 

User Id: Mho created or last updated this version. 

The version number and/or user id may be changed via the "reset 
SPF statistics" utility (option 3.5). The statistics are dis- 
played next to each member name on member selection lists, and may 
be printed by requesting an "index listing" via the library utili- 
ty (option 3.1) .... 

The following formats are used for display and printing: 

• For version number and modification level: VV.MM (e.g.* 
"LEVEL 02.15" means version 2, modification 15). 

• For creation date and date last modified: YY/MM/DD (e.g.* 
"80/12/27" means December 27, 1980). 

• For time last modified: HH-.MM (e.g., "17:20" means 5:20 PM). 

During browse and edit, the current version and modification lev- 
el is displayed in the title area (line 1) following the library 
and member name. 

On member selection lists, the following abbreviations are used 
for column headings: 

LIB - Library number (see below) 

VER.MOD - Version number and modification level 

CREATED - Creation date 

LAST MODIFIED - Date and time last modified 

SIZE - Current number of lines 

INIT - Initial number of lines 

MOD - Number modified lines 

ID - User id 

The LIB column is displayed only if a concatenated sequence of SPF 
libraries was specified. It indicates the library (1, 2, 3, or 4) 
in which the member was found. 
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LIST AND LOG FILES 



Under user option* a listing of any source module that is created 
or modified by the SPF editor may be automatically recorded in an 
SPF listing file. Source listings and other types of printed out- 
put may also be obtained from the SPF utilities. A screen "snap- 
shot" may be obtained by pressing the Print PF key. 

SPF also maintains a log of significant user activities, includ- 
ing a record of files and SPF library members which were modified 
via edit or utility options, batch jobs which were submitted, etc. 
See Appendix B for a discussion of SPF listing and log formats. 

The SPF list and log files sre generated automatically, and reside 
on the user's A-disk during the SPF session. Their CMS file ids 
are: 

SPFLIST LISTING 
SPFLOG LISTING 

These files may be printed upon termination of SPF. A user option 
is available to prevent generation of the SPF log file (see SPF 
parms, option 0.2). Generation of the SPF list file may be 
avoided by simply not requesting any SPF print functions. 



VIRTUAL CONSOLE 



During SPF operation, all CMS commands and EXECs issued by SPF are 
spooled to the user's virtual console, including commands 
requested by the user (under options 4 and 6) and commands which 
are automatically executed on behalf of the user (such as LINK and 
ACCESS commands). 

Upon termination of SPF, the user may specify if the virtual con- 
sole is to be deleted or kept. If the user specifies that the 
console is to be deleted, SPF will purge the console and set it to 
"stop" status. If the user specifies that the console is to be 
kept, SPF will leave the console in "start" status. If the con- 
sole remains in "start" status, it will be closed (released for 
printing) by CMS when the user logs off. 
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INVOCATION AND TERMINATION 



Before SPF is invoked, the user's virtual device 191 must be 
accessed as the A-disk. SPF assumes that this minidisk is avail- 
able at all times in read/write mode, and that no other user has 
write access to it. 

The SPF program development facility is invoked by entering the 
command "ISPF". (An SPF command may be established as an alias of 
ISPF. ) The first display is the primary option menu (Figure 9). 
The user may select an option by typing a one-character code in 
the option field and pressing the ENTER key, e.g., 

SELECT OPTION ===> 2 

to select the edit option. 



SELECT OPTION ===> 



SPF-VM PRIMARY OPTION MENU 
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EDIT 


3 
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4 


FOREGROUND 


5 
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6 


COMMAND 


7 
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TUTORIAL 
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EXIT 



USERID 


- 


STEFHENS 


TIME 


- 


12:47 


TERMINAL 


- 


3277 


PF KEYS 


- 
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SPECIFY TERMINAL AND SPF PARAMETERS 

DISPLAY SOURCE DATA OR OUTPUT LISTINGS 

CREATE OR CHANGE SOURCE DATA 

PERFORM SPF UTILITY FUNCTIONS 

COMPILE, ASSEMBLE, LOAD, OR TEST 

COMPILE, ASSEMBLE, OR LOAD 

ENTER CMS COMMAND OR EXEC 

TEST DIALOG OR CONVERT MENU/MESSAGE FORMATS 

DISPLAY INFORMATION ABOUT SPF 

TERMINATE SPF USING CONSOLE, LOG, AND LIST DEFAULTS 



PRESS END KEY TO TERMINATE SPF 



5 



Figure 9. Primary Option Menu 



For options that have secondary level menus (options 0, 3, 4, 5/ 
and 7), the user may bypass the second menu by typing two numbers, 
separated by a decimal point, on the primary option menu. For 
example, enteri ng "3 . 1" on the primary menu has the same effect as 
entering "3" on the primary menu and ''1" on the secondary menu. 

On initial entry, the user may also bypass the primary (and sec- 
ondary) menus by entering Qn initial option as a parameter to the 
ISPF command. Examples: 

ISPF 2 - to go directly to edit 

ISPF 3.1 - to go directly to utility suboption 1 



Invocation and Termination 
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The SPF primary options are: 

• SPF PARMS - To specify SPF parameters and defaults* includ- 
ing: terminal type, number of program function (PF) keys, 
default pad character for input fields, defaults for process- 
ing console, log, and list files, and PF key definitions. 

• BROWSE - To display source data or output listings. Browse is 
intended primarily for viewing large files such as compiler 
listings or dumps. 

• EDIT - To create or change source data, including program 
code, test data, or documentation. Unlike browse, edit reads 
the selected member (or entire sequential file) into virtual 
storage and retains it there during edit operations. 

• UTILITIES - To print, rename, or delete SPF library members or 
CMS files; specify SPF libraries; move or copy data; display 
or print SPF project listings; reset SPF library statistics; 
initiate spool output; retrieve data from the virtual reader; 
retrieve SPF libraries Cvia tape) from an MVS system; or for- 
mat SCKIPT/VS documentation. 

• FOREGROUND - To execute language processing programs in the 
foreground, including: Assembler, COBOL, FORTRAN, PL/I 
(checkout or optimizer), PASCAL, and COBOL or FORTRAN inter- 
active debug. Also included is &n interface to the LOAD com- 
mand. 

• BATCH - To generate and submit job statements and command 
streams for batch execution of IBM language processing pro- 
grams, including: Assembler, COBOL, FORTRAN, PL/I (checkout 
or optimizer), and PASCAL; or for batch LOAD. 

• COMMAND - To enter a CMS or CP command, or EXEC, during exe- 
cution of SPF. 

• SUPPORT - To test a panel or dialog function; set or examine 
dialog variables; convert old format selection and tutorial 
menus to new format panels; or convert old format messages to 
new format. 

• TUTORIAL - To obtain immediate online instruction in the use 
of SPF. The tutorial may be viewed sequentially from begin- 
ning to end, or randomly by selecting topics from the table of 
contents or alphabetized index. The tutorial may also be 
entered from other SPF options by means of the Help PF key. 

To terminate SPF, the user must be out of split screen mode. Two 
termination options are available from the primary option menu: 

1. The End PF key may be pressed to display the SPF termination 
panel (Figure 10) for specification of console, log, and list 
processi ng. 

2. Option "X" may be entered to terminate SPF with user defaults 
for processing console, log, and list files, as specified via 
SPF parms (option 0.2). If no defaults have been specified, 
option "X" causes the termination panel to be displayed. 

Note : Option "X" may also be used with the Return PF key to 
immediately terminate split screen or, in single screen mode, to 
immediately terminate SPF from any menu or entry panel, as fol- 
lows: In any panel input field or command line, enter an equal 
sign ( = ) followed by an X. Then press the Return PF key. 

The termination panel allows the user to specify whether the vii — 
tual console is to be deleted (purged and set to "stop" status) or 
kept (left in "start" status), and whether the log and list files 
are to be printed, deleted (erased), or kept without printing. 



i 
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If the log and/or list files are to be printed, the following 
spool parameters may be specified: 

• Number of copies - if more than one copy is desired. 

• Spool class - for other than class A. 

• 'For" user - to spool the output to another user's virtual 
printer on the same VM system (ignored if either 
"user/machine id" or "node/link id" i s speci f i ed) . 

• 3800 keywords - if output i s directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in VM/SP CP Command 
Reference for General Users > SC19-6211. 

• User/machine id - to spool the output to the virtual reader of 
another user or machine. 

• Node/link id - if the destination is a remote node on the net- 
work (valid with either "user/machine id" or "tag text", but 
not both) . 

• Tag text - to specify control parameters for printing on a 
remote non-VM system. See description of TAG command in 
VM/570 RSCS Networking Program Reference and Operations 
Manual , SH24-5005. 

Once the termination options have been entered, the ENTER key is 
pressed to complete termination. The screen is cleared, one or 
more termination messages is displayed, and the user is returned 
to CMS. 



) 



SPECIFY DISPOSITION OF CONSOLE, LOG, AND LIST FILES 
ENTER/VERIFY PARAMETERS BELOW: 

CONSOLE PROCESS OPTION ===> D (K OR D) 
LOG PROCESS OPTION ===> P~ (P, K, OR D) 
LIST FROCESS OPTION ===> P (P, K> OR D) 

VALID PROCESS OPTIONS: 

P - FRINT FILE (AND DELETE) 

K - KEEP FILE - DO NOT FRINT 

D - DELETE (PURGE) FILE - DO NOT PRINT 



LOG/LIST SPOOL OPTIONS: 
NUMBER OF COPIES ===> 
3800 KEYWORDS ===> 



SPOOL CLASS ===> A 



FOR' USER ===> 



FOR SPOOLING LOG/LIST TO ANOTHER PERSON OR MACHINE: 
USER/MACHINE ID ===> 
NODE/LINK ID ===> 
TAG TEXT ===> 

PRESS ENTER TO COMPLETE SPF TERMINATION 

PRESS END KEY TO RETURN TO PRIMARY OPTION MENU 



Figure 10. SPF Termination Panel 



Invocation and Termination 
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MEMBER LIST COMMANDS 



For any of the following SPF options, a member selection list will 
be displayed if an SPF library or a CMS MACLIB or TXTLIB is speci- 
fied but no member name is supplied: 

Browse 

Edit 

L i brary Uti li ty 

Move/Copy Utility 

Reset SPF Statistics Utility 

SCRIPT/VS Utility 

An example of a member list display is shown in Figure 11. The 
member selection list also shows the SPF statistics for each mem- 
ber of sn SPF library. 



BROWSE - SPFDEMO.MYLIB.PLI 
COMMAND INPUT ===> _ 
























SCROLL == 


=> PAGE 


NAME VER.MOD 


CREATED 


LAST MODIFIED 


SIZE 


INIT 


MOD 


ID 


ACCOUNT 01.00 


79/01/09 


79/01/09 


17:07 


21 


21 





KLEIN 


ACCT1 01.01 


79/01/09 


79/04/23 


14:52 


99 


193 





KLEIN 


ACCT2 01.00 


79/01/09 


79/01/09 


17:07 


20 


20 





ORR 


COINS 01.04 


79/04/24 


79/04/24 


16:20 


19 


19 


4 


ORR 


COMPX 01.00 


79/01/09 


79/01/09 


17:08 


44 


44 





ORR 


CONPY 01.01 


79/01/14 


79/01/14 


12:30 


13 


13 


1 


ORR 


DCLS 01.00 


79/04/23 


79/04/23 


15:14 


20 


20 





MOSTON 


LISTNEW 01.02 


79/04/23 


79/04/23 


15:00 


17 


13 


6 


KLEIN 


MAIN 01.00 


79/01/09 


79/01/09 


17:08 


4 


4 





MOSTON 


TESTDIR 01.02 


79/04/23 


79/05/06 


17:04 


30 


43 


10 


MOSTON 


UPDATE 01.00 


79/01/09 


79/01/09 


17:08 


13 


13 





MOSTON 


**END** 

















Figure 11. Member List Display 



LOCATING MEMBERS 



The member list may be scrolled up and down by means of the Scroll 
PF keys. In addition > a LOCATE command may be entered in the com- 
mand input field on line 2 of any member list display. Format: 



LOCATE membei — name 



Command abbreviations: L0C, L 



This causes a 
the entry for 



direct scroll to the specified member name (i.e., 
the specified name will appear as the first line 
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following the header lines). If the specified name is not found* 
scrolling is to the member name which (in the collating sequence) 
would immediately precede the specified name. 



SINGLE SELECTION MEMBER LISTS 



For browse, edit and the SCRIPT/VS utility, one member at a time 
may be selected from the list. The member may be selected in 
either of two ways: 

• Move the cursor down the left-hand side of the screen and 
enter the single character "S" in front of the desired member 
name, or 

• Enter a SELECT command in the command input field on line 2. 
The format of the SELECT command is: 



SELECT membei — name 



Command abbreviations: SEL, S 






Use of this command allows selection 
the list. For edit, selection of a 
mechanism for creating a new member. 



of a member which is not in 
nonexistent member is the 



Upon termination of browse or edit (via the End PF key) the member 
list is redisplayed with an automatic scroll to the member just 
processed. The user may then select another member or press the 
End PF key again to return to the browse or edit entry panel. 

Note : When the member list is redisplayed following browse or 
edit, it will not include new members which may have been created 
by another user (or, in split screen mode, on the other logical 
screen). To display an up-to-date list, return to the browse or 
edit entry panel, leave the member name blank, and press ENTER. 



MULTIPLE SELECTION MEMBER LISTS 



For the other utility options, multiple members may be selected 
from the list. A single character code may be typed in front of 
one or more member name(s) before pressing the ENTER key. For the 
move/copy and reset utilities, the selection code is "S". For the 
library utility, the allowable codes are "P" (for print), "R" (for 
rename), "D" (for delete), and "B" (for browse). 



s 


- 


Select 


member 


(except 1 


i brary uti 


lity) 


p 


- 


Print member 


(li 


brary 


uti 


li 


ty 


on 


ly) 


R 


- 


Rename 


member 


(li 


brary 


uti 


li 


ty 


on 


ly) 


D 


- 


Delete 


member 


(li 


brary 


uti 


li 


ty 


on 


ly) 


B 


— 


Browse 


member 


(li 


brary 


uti 


li 


ty 


on 


ly) 



When ENTER is pressed, the selected member(s) are processed and a 
confirmation indicator is displayed to the right of each member 
name that was processed. See description of the utilities for 
examples. The user may then select additional members (scrolling 
to bring them into view, if necessary) or press the End PF key to 
return to the previous panel. 






Member List Commands 
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SPF PARMS (OPTION 0) 



The SPF parms option allows the user to display and change a vari- 
ety of SPF parameters at any time during the SPF session. Changes 
remain in effect until the user changes the parameter again, and 
are remembered across sessions. The parameter options menu is 
shown in Figure 12. 



SELECT OPTION ===> 



SPF PARAMETER OPTIONS 



1 TERMINAL - SPECIFY TERMINAL CHARACTERISTICS 

2 PRINT - SPECIFY SPF CONSOLE, LOG, AND LIST DEFAULTS 

3 PF KEYS - SPECIFY PF KEYS FOR 3277 TERMINAL WITH 12 PF KEYS 



Figure 12. SPF Parameter Menu 



The following describes each of the SPF parms functions, corre- 
sponding to the three options on the secondary menu. 
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SPECIFY TERMINAL CHARACTERISTICS (OPTION 0.1) 

When this option is selected, a panel is displayed (Figure 13) 
that allows the user to specify the terminal type* number of pro- 
gram function (PF) keys, the default pad character for panel input 
fields* and the mode of operation for a 3278 Model 5. 

The initial defaults for a new user are: 

Terminal Type ===> 3277 

Number of PF Keys ===> 12 

Input Field Pad ===> N 

Screen Format ===> DATA 

After these parameters have been reviewed or changed* the user can 
press the End PF key to return to the previous menu. 



TERMINAL CHARACTERISTICS 

ENTER/VERIFY PARAMETERS BELOW: 



TERMINAL TYPE 



:==> 3277_ 



NUMBER OF PF KEYS ===> 12 



INPUT FIELD PAD ===> N 



SCREEN FORMAT ===> DATA 

(3278 MODEL 5 ONLY) 



(3277 - 3277/3275 DISPLAY STATION) 
(3278 - 3278/3276 DISPLAY STATION) 

(12 - TWELVE PROGRAM FUNCTION KEYS) 

(24 - TWENTY FOUR PROGRAM FUNCTION KEYS) 

(N - NULLS) 
(B - BLANKS) 

(DATA - FORMAT BASED ON DATA WIDTH) 

(STD - ALWAYS FORMAT 24 LINES BY 80 CHARS) 

(MAX - ALWAYS FORMAT 27 LINES BY 132 CHARS) 



Figure 13. Terminal Characteristics Panel 



Specification of terminal type allows SPF to recognize valid 
(di splayable) characters. A 3278 terminal can display 6 more 
characters than a 3277. Users of 3279 terminals should specify 
3278 as the terminal type* since a 3279 terminal has the same 
character set as a 3278. 

Note : One or more of following installation-dependent options for 
terminal type may also be included on this panel: 

3278CF - for 3278 Canadian French terminals 
3277KN - for 3277 Katakana terminals 
3278KN - for 3278 Katakana terminals 



) 



SPF will automatically determine the terminal type during SPF 
initialization* and set it to the appropriate value. 
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SPF will automatically set (or change) the number of PF keys in 
the following cases: 

• If the terminal type is 3277, SPF will initialize the number 
of keys to 12. 

• If the terminal type is 3278, SPF will initialize the number 
of keys to whatever was "remembered" from the user's last SPF 
session (for a new user, the number of keys is initialized to 
12). 

• If the user presses a PF key higher than 12, SPF will set the 
number of keys to 24. 

SPF cannot sense the number of PF keys if the user switches from a 
3278 with 24 PF keys to a 3278 with 12 PF keys. In this case, the 
user must inform SPF of the number of PF keys via option 0.1. 
Otherwise, the incorrect set of "remembered" key definitions will 
be used (see option 0.3). 

Specification of a pad character controls the initial padding of 
panel input fields (including selection menus) but not the data 
portion of an edit display. Within edit, null or blank padding is 
controlled with edit commands. 

Specification of screen format applies to 3278 Model 5 terminals 
only; it is ignored for other types of terminals. If DATA is 
specified, SPF will automatically switch between the larger "de- 
fault" mode characters (24 lines by 80 characters) and the smaller 
"native" mode characters (27 lines by 132 characters), based on 
the width of the data to be displayed. If STD or MAX is speci- 
fied, the mode will not be switched. 
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SPECIFY CONSOLE, LOG, AND LIST DEFAULTS (OPTION 0.2) 



When this option is selected, a panel is displayed that allows the 
user to specify default processing for the virtual console and for 
the SPF log and list files, to be 
primary option "X" (Figure 14). 
have not been specified, primary 
termination menu to be displayed. 



used when SPF is terminated via 
If default processing options 
option "X" will cause the SPF 



) 



CONSOLE > LOG, 

ENTER/VERIFY PARAMETERS BELOW: 



AMD LIST DEFAULTS 



CONSOLE PROCESS OPTION ===> 
LOG FROCESS OPTION ===> 
LIST PROCESS OPTION ===> 



(K OR D) 

(P, K> D, OR N) 

(P, K OR D) 



LINES PER PAGE: 
LOG ===> 60 
LIST ===> 60 



VALID PROCESS OPTIONS: 

P - PRINT FILE (AND DELETE) 

K - KEEP FILE - DO NOT PRINT 

D - DELETE (PURGE) FILE - DO NOT PRINT 

N - DO NOT GENERATE LOG FILE 



LOG/LIST SPOOL OPTIONS: 
NUMBER OF COPIES ===> 1 
3800 KEYWORDS ===> 



SPOOL CLASS ===> A 



'FOR' USER ===> 



FOR SPOOLING LOG/LIST TO ANOTHER PERSON OR MACHINE: 
■TO' USER/MACHINE ===> 
REMOTE NODE ID ="> 
TAG KEYWORDS ===> 



Figure 14. Console, Log, and List Defaults Panel 



) 



The number of lines p&r page and spool parameters for printing the 
log and list files may also be specified. The initial defaults 
for new users are: 



Lines per page = 
Number of copies = 
Spool class = 



==> 60 (for both log and list) 
==> 1 
= = > A 



No other SPF-supplied initial defaults are provided for the other 
parameters on this panel. 

Normal values for lines per page are: 

60 - for printing 6 lines per inch 
80 - for printing 8 lines per inch 

The virtual console is automatically started the first time SPF 
invokes a CMS command (typically, a LINK or ACCESS executed auto- 
matically on behalf of the user). Upon termination of SPF, the 
console may be kept (in "start" status) or deleted (purged and set 
to "stop" status). An appropriate processing option for the con- 
sole would be: 

K - if the user normally runs with a virtual console 

D - if the user normally runs without a virtual console. 
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The SPF log file is created the first time the user performs some 
action which results in a log message, such as saving edited data 
or submitting a job to the batch machine. The SPF list file is 
created the first time the user requests a "print function. 

For the log file, a process option of "N" may be specified to pre- 
vent generation of the log. Generation of the list file may be 
avoided by simply not requesting any print functions. 

See section entitled "Invocation and Termination" for a dis- 
cussion of spool parameters that may be specified for the log and 
li st f i les. 

After the parameters on this panel have been reviewed or changed, 
the user can press the End PF key to return to the previous menu. 



SPECIFY SPF PROGRAM FUNCTION KEYS (OPTION 0.3) 

When this option is selected, a panel is displayed that allows the 
user to specify the mapping of the PF keys into specific functions 
(Figure 15). Before selecting this option, the user should 
ensure that the correct terminal type (3277 or 3278) and number of 
PF keys (12 or 24) has been specified via option 0.1. 

SPF maintains three different sets of key definitions for each 
user, as follows: 

3277 (or 3275) with 12 PF keys 

3278 (or 3276 or 3279) with 12 PF keys 
3278 (or 3276 or 3279) with 24 PF keys 

The appropriate set of key definitions will be invoked based on 
the terminal type and number of keys (as specified via option 
0.1). The panel shown in the figure is for a 3278 with 24 PF keys. 

The allowable SPF-defined key functions ar& listed at the bottom 
of the menu. See section entitled "Program Access and Function 
Keys" for a description of these functions. More than one key can 
be assigned to the same function. A function need not be assigned 
to a key, with one exception: There must be at least one End PF 
key assigned within the first 12 keys. 

Entering a blank for any PF key definition causes the specified PF 
key to be assigned its SPF default. The default key definitions 
are discussed under "Program Access and Function Keys" and sre 
also shown in Figure 15. 



26 SPF-VM Program Reference 





ENTER/VERIFY PARAMETERS BELOW FOR 3278 TERMINAL WITH 


24 PF KEYS: 


PF1 ==> HELP 




PF13 


==> HELP 


PF2 ==> SPLIT 




PF14 


==> SPLIT 


PF3 ==> END 




PF15 


==> END 


PF4 ==> RETURN 




PF16 


==> RETURN 


PF5 ==> FIND 




PF17 


==> FIND 


PF6 ==> CHANGE 




PF18 


==> CHANGE 


PF7 ==> UP 




PF19 


==> UP 


PF8 ==> DOWN 




PF20 


==> DOWN 


PF9 ==> SWAP 




PF21 


==> SWAP 


PF10 ==> LEFT 




PF22 


==> LEFT 


PF11 ==> RIGHT 




PF23 


==> RIGHT 


PF12 ==> CURSOR 




PF24 


==> CURSOR 


VALID OPTIONS: 


(BLANK RESETS TO DEFAULT OPTION) 






HELP 


SPLIT END RETURN FIND 


CHANGE 


UP 


DOWN SWAP LEFT RIGHT 


CURSOR 


NOP 


PRINT PRINT-HI 






OR EQUATE TO EDIT/BROWSE COMMAND: 






>CMD... 


(PRIMARY COMMAND) EXAMPLE: PF10 


==> >TABS ON 


:CMD... 


(EDIT LINE COMMAND) EXAMPLE: PF11 




I 



Figure 15. PF Key Assignment Panel (For 24-key Terminals) 



) 



The user may equate a PF key to an edit or browse primary command, 
or to an edit line command, in the following manner: 

>string Causes the specified PF key, when used in edit or browse, 
to simulate the entering of a primary command. Example: 

PF10 ===> >FIND ABC 

Pressing PF10 when browsing or editing data will have 
the same effect as entering a FIND ABC primary command. 



string Causes the specified PF key, when used in edit, 
simulate the entering of a line command. Example: 

PF11 ===> :TF 



to 



) 



Pressing PF11 when editing data will have the same 
effect as entering the "TF" (text flow) line command on 
whichever line the cursor is positioned when the key is 
pressed. 
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BROWSE (OPTION 1) 



The browse option allows the user to di splay source data and 
listings stored in SPF libraries or CMS files with the following 
characters! ti cs: 

• Fixed or variable record formats 

• Logical record lengths up to and including 32767 bytes 

When browse is selected* and entry panel is displayed to allow the 
user to specify either an SPF library or CMS file id. A user id, 
virtual device address, LINK access mode, and read password may 
also be specified, if needed, for linking to another user's vii — 
tual disk. See Figure 16. 

For SPF libraries, MACLIBs, and TXTLIBs, the user can supply the 
name of the member to be browsed, or can leave the member name 
blank to request a member list from which a member may be 
selected. 

When the user has properly specified the datQ to be viewed, the 
first page of data is displayed. Two lines are reserved at the 
top of the screen for title information, short messages, command 
entry, and the scroll amount. The remainder of the screen con- 
tains the data (Figure 17). 

Note ; Under browse, any invalid (non-di splayable) characters in 
the data are displayed as periods. 

During browse, foui — way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll to a 
particular character string, line number, or symbolic label. 

Browse provides six commands, described in the following 
sections, which may be entered in the command input field on line 
2: 

LOCATE FIND 

COLS CAPS 

RESET HEX 

Browse may be terminated by pressing the End PF key, which causes 
a return to the previous display (either the member selection list 
or the browse entry panel). When return is to the member 
selection list, the member just browsed will appear at the top of 
the list. Another member may be selected from the list or the End 
key may be pressed again to return to the browse entry panel. 

When the entry panel is displayed, another file or member may be 
selected, or the End key may be pressed to return to the primary 
opt i on menu . 
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BROWSE - ENTRY PANEL 

ENTER/VERIFY PARAMETERS BELOW: 



SPF LIBRARY: 
PROJECT ===> 
LIBRARY ===> 
TYPE ===> 
MEMBER ===> 



(BLANK FOR MEMBER SELECTION LIST) 



CMS FILE: 

FILE ID ===> CBLMAIN COBOL Al_ 

MEMBER ===> (FOR MACLIB OR TXTLIB) 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE == 

READ PASSWORD ===> 



Figure 16. Browse - Entry Panel 



) 



BROWSE - CBLMAIN COBOL Al LINE 00000 COLS 001 080 

COMMAND INPUT ===> _ SCROLL ===> PAGE 

**#***«******#******************* TOP OF DATA ************#*********-CAPS ON-** 

000100 IDENTIFICATION DIVISION. 

000200 PROGRAM-ID. 'F20D1000'. 

000300 DATE-COMPILED. AUG. 20, 1979 

000400 ENVIRONMENT DIVISION. 

000500 CONFIGURATION SECTION. 

000600 SOURCE-COMPUTER. IBM-370. 

000700 OBJECT-COMPUTER. IBM-370. 

000S00 INPUT-OUTPUT SECTION. 

000900 FILE-CONTROL. 

001000 SELECT OLD-COMREC ASSIGN TO DA-S-DD1. 

001100 SELECT Dl-REPORTS ASSIGN TO UR-S-D10UT. 

001200 SELECT OPTION-CARD-FILE ASSIGN TO UR-S-SYSIN. 

001300 DATA DIVISION. 

001400 FILE SECTION. 

001500 FD OLD-COMREC 

001600 LABEL RECORD IS STANDARD 

001700 RECORDING MODE IS F 

001800 BLOCK CONTAINS RECORDS 

001900 DATA RECORD IS COMREC1. 

002000 01 COMREC1. 

002100 02 DUMMY PICTURE X(520). 

002200 FD Dl-REPORTS 

002300 LABEL RECORD IS OMITTED 

002400 RECORDING MODE IS F 

002500 BLOCK CONTAINS 133 CHARACTERS 






Figure 17. Browse - Data Display 



Browse (Option 1) 



29 



LOCATING LINES 



During browse, the current position of the screen window is indi- 
cated by the line/column numbers in the upper right hand corner of 
the screen. The line number refers to the first data line current- 
ly being displayed (i.e., the first line after the two header 
lines). It indicates the relative position of that line in the 
data, and is unrelated to any sequence numbers that may be con- 
tained within the data. The "TOP OF DATA" message is treated as 
relative line zero. 

The LOCATE command may be used to scroll directly to a specified 
line number. It may also be used to scroll to a symbolic label, 
which must have been previously defined by the user, as follows: 

Scroll to any desired line and enter a label of the form: 

.xxxxxxx 

(period followed by up to seven alphameric characters) in the com- 
mand input line. The label is treated as an internal symbol and 
equated to the top line on the screen. Labels are not retained 
upon exit from browse. 

Format of the LOCATE command: 



LOCATE line-number/label 



Command abbreviations: LOC, L 



Either a line number or a label must be entered as an operand. 

The "line-number" operand is a numeric value of up to eight digits 
(leading zeros need not be typed), which refers to the relative 
line number as displayed in the upper right hand corner. 

The "label" operand consists of a period (.) immediately followed 
by up to seven alphameric characters. Scrolling is performed to 
the line which was previously equated to the label, as described 
above. 

Note : The period is mandatory when defining a label. It is 
optional when referring to a label in a LOCATE command unless the 
label begins with a numeric character, in which case the period is 
required to distinguish the label from a line number. 
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IDENTIFYING COLUMNS 



The COLS command causes a column identification line to be dis- 
played, temporarily overlaying the first data line. The RESET 
command terminates display of the column identification line. 
Formats: 



COLS 



Command abbreviation: COL 



RESET 



Command abbreviation: RES 



Neither command uses any parameters. 

An example of the column identification line 
Figure 18. The digits on the identification line 
"tens" positions* e.g., "1" indicates column 10, 
column 20, etc. The plus signs (+) indicate the 
tions. 



i s shown i n 

indicate the 

"2" indicates 

"fives" posi- 







BROWSE 
COMMAK 






ID INPUT ===> _ SCROLL ===> PAGE 


002200 


FD 


Dl -REPORTS 


002300 




LABEL RECORD IS OMITTED 


002400 




RECORDING MODE IS F 


002500 




BLOCK CONTAINS 133 CHARACTERS 


002600 




DATA RECORD IS Dl-LINE. 


002700 


01 


Dl-LINE. 


002S00 




02 COLUMNS PICTURE X(133). 


002900 


FD 


OPTION-CARD-FILE 


003000 




LABEL RECORD IS OMITTED 


003100 




BLOCK CONTAINS 1 RECORDS 


003200 




RECORDING MODE IS F 


003300 




DATA RECORD IS O-C. 


003400 


01 


O-C. 


003500 




02 DUMMY PICTURE X(80). 


003600 


WORKING-STORAGE SECTION. 


003700 




77 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 


003800 




77 PREV-DEVICE-TYPE-CODE PICTURE X VALUE "I 1 . 


003900 




77 PREV-ACTV-CODE PICTURE 9 VALUE 0. 


004000 




77 PREV-PROB-CODE PICTURE 9 VALUE 0. 


004100 




77 C-SWITCH PICTURE X VALUE '0'. 


004200 




77 PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 


004300 




77 GSA-REF PICTURE XX. 


004400 




77 UNIT-PRICE-NUMERIC PICTURE S9(8)V99. 


004500 




77 BML-NUMERIC PICTURE S9(8)V99. 


004600 




77 PREV-MODEL PICTURE X(5) VALUE "0'. 



w 



Figure 18. Browse - Column Identification Line 
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FINDING CHARACTER STRINGS 

The FIND command is used to find one or more occurrences of a 
specified character string. It allows special forms of character 
strings and several optional parameters to control: 

• Starting point and direction of search 

• Special conditions to control character string "match" 

• Column limitations on extent of search 

The command summary, which follows, describes the basic form of 
FIND which is most frequently needed. The remainder of this 
section provides detailed information about the various special 
features and options. 



Command Summary 



The basic format for FIND is: 



FIND string CALL] 



Command abbreviation: F 



The operands may be separated by blanks or commas. The ALL opei — 
and is optional, and may precede or follow the string. 

As a general rule, the strings sre typed without delimiters. For 
example: 

FIND XYZ 



to find the next occurrence of XYZ. 

Strings may be delimited with either apostrophes (') or quotation 
marks ("). Delimiters must be used if a string contains imbedded 
blanks or commas, or if a string is the same as a command keyword. 
For example: 



(which contains a 



FIND 'EVERY ONE 1 

to find the next occurrence of "EVERY ONE" 
blank) . ■ . 

If the ALL operand is omitted, the FIND command searches for the 
next occurrence of the string starting at the current cursor 
location. (If the cursor is not in the data area of the screen, 
scanning starts at the beginning of the first line which is cur- 
rently being displayed.) Scrolling is performed, if necessary, to 
bring the string into view. The cursor is positioned under the 
string and a verification message is displayed in the upper 
right-hand corner of the screen. The Find PF key may be used to 
find each successive occurrence of the string. 

If the string is not found between the current cursor location and 
the end of data, a "BOTTOM OF DATA REACHED" message is displayed 
and the audible alarm is sounded (if installed). The Find PF key 
may then be used to wrap to the top of data and continue search- 
ing. If the string is not found anywhere in the data a "NO xxxxx 
FOUND" message is displayed. 

If the ALL operand is typed, the FIND command searches for all 
occurrences of string starting at the top of the data, and posi- 
tions the cursor under the first occurrence. The verification 
message indicates the number of occurrences found. 
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Detailed Command Description 

The complete format for FIND* showing all optional parameters* 
follows: 



FIND string C NEXT /ALL/FIRST/LAST/PREV3 
[ CHARS /PREFIX/SUFFIX/MQRD3 
Ccol-1 tcol-2]] 



Command abbreviation: F 

Keyword abbreviations: PRE (for PREFIX), SUF (for suffix) 



■ 



The operands may be separated with blanks or commas, and may be 
typed in any order except that col-2, if typed, must follow col-1. 
The string operand is required; the others are optional. 

The "string" operand specifies the string to be found. It may be 
specified in any one of the following forms: 

• Any string of characters not starting or ending with an apos- 
trophe or quotation mark, and not containing any imbedded 
blanks or commas. 

• A delimited string: Any string starting and ending with an 
apostrophe (") but not containing imbedded apostrophes, or 
starting and ending with a quotation mark (") but not contain- 
ing imbedded quotation marks. 

• A hex string: Any delimited string of valid hexadecimal chai — 
acters, preceded or followed with the character X. Example: 
X'CZTB' 

• A text string: Any delimited string of characters, preceded 
or followed with the character T. See discussion under "Use 
of Text Strings." Example: T'conditions for' 

• A picture string: Any delimited string of picture charac- 
ters, preceded or followed with the character P. See dis- 
cussion under "Use of Picture Strings." Example: P'.' 

• A single asterisk (*). This causes the previous value of 
"string" that was used in a FIND command to be used again. 
The previous value of a character string (referenced via * or 
used by the Find PF key) is retained until the browse option 
is terminated (i.e. until return to the primary option menu). 



Starting Point and Direction of Search 

The starting point, direction and extent of the search may be 
controlled by one of the following operands. 

NEXT Scan starts at the current cursor location and proceeds 
forwards to find the next occurrence of the string. 

ALL Scan starts at the top of data and proceeds forwards to 
find all occurrences of the string. 

FIRST Scan starts at the top of data and proceeds forwards to 
find the first occurrence of the string. 

LAST Scan starts at the bottom of data and proceeds backwards to 
find the last occurrence of the string. 

PREV Scan starts at the current cursor location and proceeds 
backwards to find the previous occurrence of the string. 

If this operand is omitted, the default is NEXT. 
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If the direction of the search is forward (i.e, if FIRST* ALL, or 
NEXT was specified), pressing the Find PF key finds the next 
occurrence of the designated string. If the direction of the 
search is backward (i.e., if LAST or PREV was specified), pressing 
the Find PF key finds the previous occurrence of the designated 
string. The other optional parameters (CHARS, WORD, PREFIX, SUF- 
FIX, col-1, and col-2) remain in effect, as specified on the last 
FIND command. 

The search proceeds until one or all occurrences of the string are 
found, or until the end of data is encountered. If the string is 
not found, one of the following actions takes place. 

♦ For FIRST, LAST, or ALL - a "NO xxxxx FOUND" message is dis- 
played in the upper right-hand corner of the screen. 

♦ For NEXT - a "BOTTOM OF DATA REACHED" message is displayed. 

♦ For PREV - a "TOP OF DATA REACHED" message is displayed. 

When "BOTTOM OF DATA REACHED" or "TOP OF DATA REACHED" is dis- 
played, the user may press the Find PF key to continue searching 
by wrapping to the top (or bottom) of the data. If no occurrence 
is found anywhere in the data, a "NO xxxxx FOUND" message is dis- 
played. 



Conditions for Character String Match 

The conditions for a successful "match" with the string may be 
controlled based on whether the data string begins and/or ends 
with a non-alphameric character (i.e., a special character or 
blank). The operands are: CHARS, PREFIX (may be abbreviated 
PRE), SUFFIX (may be abbreviated SUF) , and WORD. In the following 
illustration, the underscored strings would be found, and the 
non-underscored strings would be ignored (skipped over). 



CHARS 'DO' 


- DO 


DONT 


APO 


ADOPT 


'DO' 


+ADO 


(DONT) 


ADO- 


PREFIX 'DO 1 


- DO 


DONT 


ADO 


ADOPT 


•DO' 


+ADO 


(DONT) 


ADO- 


SUFFIX 'DO' 


- DO 


DONT 


ADO 


ADOPT 


'DO' 


♦ADO 


(DONT) 


ADO- 


WORD 'DO' 


- DO 


DONT 


ADO 


ADOPT 


•DO' 


+ADO 


(DONT) 


ADO- 



If this operand is omitted, the default is CHARS. 



Column Limitations 



If the "col-1" and "col-2" operands are typed (two integers 
separated by a comma or at least one blank), they indicate the 
starting and ending column positions for the search. If col-1 is 
specified without col-2, the string will be found only if it 
starts in the specified column. If neither col-1 nor col-2 is 
specified, the search will continue across all columns. 



34 SPF-VM Program Reference 



Use of Text Strings 



A text string, which may be used as the string in a FIND command, 
allows the search to be satisfied without regard to upper/lower 
case alphabetics. Example: FIND T'CONDITION NO. 1" would suc- 
cessfully find any of the following: 

CONDITION NO. 1 

Condition No. 1 

condition no. 1 

coNDitlON nO. 1 



An ordinary delimited string, such as: FIND "CONDITION 
would find only the first example listed above. 



NO. 



Within the text string itself* is is immaterial whether alphabet- 
ics are typed in upper or lower case (even if CAPS mode is off) 
For example, all the following have the same effect: 

FIND T'Edit Commands' 
FIND T'EDIT COMMANDS' 
FIND T'edit commands' 



Use of Picture Strings 



A picture 

comma 

of cha 

the p 

as follows: 




STRING MEANING 



) 



P'=' - any character (don't care) 

P'-*' - any non-blank character 

P*. ' - any non-di splayable (invalid) character 

P'#' - any numeric character (0-9) 

P'-' - any non-numeric character 

P'3>' - any alphabetic character (upper or lowercase) 

P'<' - any lowercase alphabetic character 

P'>' - any uppercase alphabetic character 

P'$' - any special character (not alpha or numeric) 

Any special characters other than the ones listed above are inval- 
id within a picture string. A picture string may also include any 
alphabetic or numeric characters, in which case the characters 
represent themselves. 

Examples of picture strings: 



Jr 



P*###' - a string of three numeric characters 

P'-» -' - any two non-blank characters surrounding a blank 

P*.* - any non-di splayable character 

P' t' - a blank followed by a numeric character 

P'ftAB' - a numeric character followed by 'AB' 



Examples of FIND command using picture strings: 



FIND P'.' 
FIND P'-' 72 
F P' -' 1 



- find the next non-di splayable character 

- find the next non-blank character in col 

- find the next line with a blank in col 1 
followed by a non-blank 



72 



When the picture string P'.' is used to find a non-di splayable 
character, the hexadecimal representation of the character is 
shown in the confirmation message which appears in the upper 
right-hand corner of the screen. 
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CHARACTER STRING TRANSLATION 



If the character string operand of the FIND command contains 
alphabetic characters, they are automatically translated to upper 
case if browse is operating with CAPS mode on; they are left as-is 
(not translated) if browse is operating with CAPS mode off. 



CAPS mode may be turned on or off by using the CAPS command, 
mat: 



For- 



CAPS CON/OFF] 



If the ON/OFF operand is omitted, ON is 
browse, CAPS mode is always initialized ON. 



the default. 



Under 



Note : The "TOP OF DATA" and "BOTTOM OF DATA" lines 
indication of the current mode. 



contain an 



HEXADECIMAL DISPLAY 



When browse is operating in HEX mode, three lines are displayed 
for each source line. The first line shows the data in standard 
character form. The following two lines show the same data in 
hexadecimal representation. See Figure 19. 

Note : The FIND command may also be used to find invalid characters 
or any specific hex character, regardless of the setting of HEX 
mode. See discussion of picture strings and hex strings under the 
FIND command. 



HEX mode may be turned on or off by using the HEX command, 
mat: 



Foi — 



HEX [ON/OFF] CVERT/DATA3 



The operands may be typed in any order, 
omitted, ON is the default. 



If the ON/OFF operand is 



The VERT (vertical) and DATA operands are valid only when HEX mode 
is turned on. VERT causes the hexadecimal representations to be 
displayed vertically (two rows per byte) under each character, as 
shown in Figure 19. DATA causes the hexadecimal representations 
to be displayed as a string of hex characters (two per byte). 
Since the hex string is twice as long as the data string, it con- 
sumes two rows. If this operand is omitted, VERT is the default. 
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BROWSE - BHEX SCRIPT CI LINE 00000 COLS 001 080 

COMMAND INPUT ===> _ SCROLL ===> PAGE 

********************************* TOP OF DATA **********************-CAPS ON-** 

CH3. HEXADECIMAL DISPLAY 

7CF4CCECCCCCDCD4CCEDDCE 

A83B8571453941304927318 

WHEN BROWSE IS OPERATING IN HEX MODE, THREE LINES ARE DISPLAYED FOR EACH 
ECCD4CDDEEC4CE4DDCDCECDC4CD4CCE4DDCC64ECDCC4DCDCE4C0C4CCEDDCECC4CDD4CCCC 
685502966250920675913957095085704645B03895503955201950492731854066905138 

SOURCE LINE. THE FIRST LINE SHOWS THE DATA IN STANDARD CHARACTER FORM. 
EDEDCC4DCDC444ECC4CCDEE4DCDC4ECDEE4ECC4CCEC4CD4EECDCCDC4CCCDCCECD4CDDD4 
26493503955B0038506992303955028662038504131095023154194038191335906694B 

THE FOLLOWING TWO LINES SHOW THE SAME DATA IN HEXADECIMAL 
ECC4CDDDDECDC4EED4DCDCE4ECDE4ECC4ECDC4CCEC4CD4CCECCCCCDCD 
385066336695703660395520286603850214504131095085714539413 

REPRESENTATION. SEE CFIGREF REFID='BHEX' . . 
DCDDCECDECECDD444ECC47CCCDCCADCCCC77CCCE744 
95795255313965B002550A697956195694ED28S7DBB 

CNOTE.THE FIND COMMAND MAY ALSO BE USED TO FIND INVALID CHARACTERS, 
7DDEC4ECC4CCDC4CDDDCDC4DCE4CDED4CC4EECC4ED4CCDC4CDECDCC4CCCDCCECDE6 
A5635B385069540364415404180132602504254036069540955139403819133592B 

REGARDLESS OF THE SETTING OF HEX MODE. SEE DISCUSSION OF PICTURE 



Figure 19. Browse - Hexadecimal Display, Vertical 
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EDIT (OPTION 2) 



The edit option allows the user to create, display, and modify 
source data (program code, test data, documentation, etc.) stored 
in SPF libraries or CMS files with the following characteristics: 

• Fixed or variable record formats 

• Logical record lengths up to and including 255 bytes, but not 
less than 10 bytes 

The edit entry panel is shown in Figure 20. For edit, a concat- 
enated sequence of SPF libraries may be specified. The concat- 
enated sequence applies to fetching of members to be edited. The 
libraries are searched in the designated order to find the member 
and bring it into working storage. When the edited member is 
saved, it is placed (or replaced) in the first library in the con- 
catenation sequence regardless of which library it came from. 

If a member selection list is requested, it includes an indication 
of the library where the member was found (library 1, 2, 3, or 4). 
See Fi gure 21 . 

If a CMS file id is specified and the file does not currently 
exist, the record format (RECFM) and logical record length 
(LRECL) may be specified on the panel. If these fields are left 
blank, the RECFM and LRECL which the user last specified for this 
filetype will be used. If the user has never specified a RECFM 
and LRECL for this filetype, the new file will be created with 
RECFM=F (fixed) and LRECL=80. 

If the minidisk is password protected, an update password must be 
specified. For a concatenated sequence of SPF libraries which do 
not reside on the same minidisk, two passwords may be required: 
An update password for the first library in the concatenation 
sequence, and a read password for the other libraries (which must 
all be accessable via the same password) . 

The edit entry panel also allows specification of a profile name, 
which may be entered to override the default edit profile. See 
description under "Edit Modes and Profiles." 

SPF libraries must have been previously specified to SPF (see 
"File Utility", option 3.2). Selection of a nonexistent CMS 
sequential file or a nonexistent member of a library allows cre- 
ation of a new file or member. 

The selected member or sequential file is read into virtual stoi — 
age, where it is updated during edit operations. Use of virtual 
storage for edit work space results in high performance, but may 
require a large virtual machine. Warning messages will be dis- 
played if the amount of available virtual storage drops below 50K 
bytes. If all available storage is consumed an ABEND will occur, 
and the edit work space will be lost unless the user is operating 
with RECOVERY mode on. 

The edit data display is similar to a browse display except that 
each line consists of a 6-column line command field followed by a 
72-column data field (see Figure 22). The line command fields 
contain numbers that reflect the contents of the sequence numbers 
in the data. If the data has no sequence numbers, the line command 
f i elds contai n numbers that start at 1 and are incremented by 1. 

Notes: 

1. Under edit, any invalid (non-di splayable) characters are 
replaced on the screen (but not in the data) with attribute 
bytes, which display as blanks and may not be overtyped. 

2. Invalid characters may be displayed and edited by entering 
HEX mode (see description of HEX command) or by using the FIND 
and CHANGE commands. 
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ENTRY PANEL 










ENTER/VERIFY PARAMETERS 


BELOW: 










SPF LIBRARY: 














PROJECT ===> SPFDEMO 














LIBRARY ===> MYLIB 


===> MASTER "=> 


sr=> 








TYPE ===> PLI 














MEMBER ===> _ 


(BLANK FOR MEMBER SELECTION LIST) 








CMS FILE: 






FOR NEW CMS FILE: 






FILE ID ===> 






RECFM ===> 


(F 


OR 


V) 


MEMBER ===> 






LRECL ===> 








IF NOT LINKED, SPECIFY: 












OWNER'S ID ===> 


DEVICE 


ADDR. ===> 


LINK ACCESS 


MODE ' 


===> 


READ PASSWORD ===> 


UPDATE 


PASSWORD =" 


:> 








PROFILE NAME ===> 


(BLANK 


DEFAULTS TO 


TYPE) 









Figure 20. Edit - Entry Panel 



EDIT SPFDEMO 

COMMAND INPUT === 


MYLIB. PLI 
























SCROLL == 


=> PAGE 


NAME 


LIB 


~VER.MOD 


CREATED 


LAST MODIFIED 


SIZE 


INIT 


MOD 


ID 


ACCOUNT 


1 


01.00 


79/01/09 


79/01/09 


17:07 


21 


21 





KLEIN 


ACCT1 


1 


01.01 


79/01/09 


79/04/23 


14:52 


99 


193 





KLEIN 


ACCT2 


1 


01.00 


79/01/09 


79/01/09 


17:07 


20 


20 





ORR 


ACCT3 


2 


01.02 


79/01/09 


79/04/23 


15:07 


21 


21 


3 


HOSTETL 


ACCT4 


2 


01.00 


79/04/23 


79/04/23 


15:04 


99 


99 





HOSTETL 


ACCT5 


Z 


01.01 


79/04/23 


79/04/23 


15:09 


22 


20 


4 


HOSTETL 


COINS 


1 


01.04 


79/04/24 


79/04/24 


16:20 


19 


19 


4 


ORR 


COMPX 


1 


01.00 


79/01/09 


79/01/09 


17:08 


44 


44 





ORR 


COMPY 


1 


01.01 


79/01/14 


79/01/14 


12:30 


13 


13 


1 


ORR 


DCLS 


1 


01.00 


79/04/23 


79/04/23 


15:14 


20 


20 





MOSTON 


LISTNEW 


1 


01.02 


79/04/23 


79/04/23 


15:00 


17 


13 


6 


KLEIN 


MAIN 


1 


01.00 


79/01/09 


79/01/09 


17:08 


4 


4 





MOSTON 


MINUS 


2 


01.03 


74/10/04 


79/01/09 


16:57 


19 


19 


2 


JOSLIN 


PLUS 


2 


01.00 


79/01/09 


79/01/09 


17:08 


44 


44 





JOSLIN 


TESTDIR 


1 


01.02 


79/04/23 


79/05/06 


17:04 


30 


43 


10 


MOSTON 


UPDATE 


1 


01.00 


79/01/09 


79/01/09 


17:08 


13 


13 





MOSTON 


ZCOMP 


2 


01.01 


79/01/14 


79/01/14 


12:30 


13 


13 


1 


KLEIN 


**END** 





















> 



Figure 21. Edit - Member Selection List 
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C31) AUTOMATIC 

(31), 

(31), 

(31), 

(31), 



EDIT — SPFDEMO.MYLIB.PLK COINS) . - 01.04 r COLUMNS 001 072 

COMMAND INPUT ===> _ SCROLL ===> HALF 

****** *************************** TOP OF DATA ******************************** 

000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY 

000600 QUARTERS FIXED BINARY 

000700 DIMES FIXED BINARY 

000800 NICKELS FIXED BINARY 

000900 SYSFRINT FILE STREAM OUTPUT PRINT; 

001000 DO HALVES = 100 TO BY -50; 

001100 DO QUARTERS = (100 - HALVES) TO BY -25; 

001200 DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY -10; 

001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001400 PUT FILE(SYSPRINT) DATA(COUNT, HALVES, QUARTERS, DIMES, NICKELS) ; 

001500 COUNT = COUNT + 1; 

001600 END; 

001700 END; 

001800 END; 

001900 END COINS; 

****** *************************** BOTTOM OF DATA ***************************** 



Figure 22. Edit - Data Display 



SUMMARY OF EDIT OPERATIONS 



Under edit, foui — way scrolling is available via the Scroll PF 
keys. The FIND and LOCATE commands may also be used to scroll to a 
particular character string or line number. 

To modify one or more lines of data, the user simply moves the 
cursor to the desired location and enters the new information by 
overtyping the existing lines. Several lines may be modified 
before pressing the ENTER key. 



Edit Commands 



Two types of commands are used to control edit operations: 

• Line commands — may be entered in the line command field on 
any line by overtyping the number that i s di splayed in that 
field. 

• Primary commands — may be entered in the command input field 
at the top of the screen (line 2). 

Line commands are used to delete, insert, duplicate, or rearrange 
lines of data, or to shift the contents of a line left or right 
(for indentation changes). 

Single character line commands operate on individual lines (e.g., 
D to delete a line, I to insert a blank line, M to move a line). 
Double character line commands operate on blocks of lines (e.g., 
DD on two different lines to indicate the first and last lines to 
be deleted). In most cases, a number may follow the line command 
to indicate multiple occurrences (e.g., 13 to insert three blank 
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lines). Several line commands as well 
be typed before pressing the ENTER key. 



as data modifications may 



Note ; The SPF editor does not distinguish between "input mode" 
and "edit mode." The I (insert) line command is used to add new 
lines* either between existing lines or at the end of the data. 
When an empty is specified for editing, the initial display con- 
tains several inserted lines between the "TOP OF DATA" and "BOTTOM 
OF DATA" message lines (Figure 23). 

Primary commands, entered at the top of the screen, are used to 
control edit modes, locate a specific line, submit data to the job 
stream, find and change character strings, control sequence num- 
bering and character translation, effect segmentation changes 
(splitting a member into two members or merging two members into 
one), save the edited data, or cancel without saving. 



EDIT — NEWFILE COBOL Al COLUMNS 007 078 

COMMAND INPUT ===> _ SCROLL ===> HALF 

****** *************************** TOP OF DATA ******************************** 



****** *************************** BOTTOM OF DATA ***************************** 



Figure 23. Edit - Creating New Data 



) 



A new SPF user need not master all the line commands and primary 
commands to make effective use of edit. The command descriptions 
in this manual are grouped under the following headings: 

• Basic Line Commands - Describes the commands used for identi- 
fying columns, inserting and deleting lines, repeating lines, 
moving and copying lines, and rules for entering line com- 
mands. Should be read by all users. 




Finding and Changing Character Strings - Contains a summary 
of the FIND and CHANGE commands, which should be read by all 
users, followed by a detailed description of FIND/CHANGE 
optional parameters and features. 
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• Advanced Features - Describes the commands used for line mask 
definition* indentation changes, boundary column definition, 
excluded lines, segmentation changes, nulls control, tabs 
definition and control, profile display and control, and 
hexadecimal display. 

• Text Preparation Features - Describes the commands used for 
character translation, text entry and edit, and overlaying 
lines. 

A list of edit commands, and the section under which each is 
described, is shown in Figure 24. A command summary may also be 
found in Appendix C, and a quick reference summary in Appendix D. 



DOCUMENT 










SECTION 


EDIT LINE 


COMMANDS 


EDIT PRIMARY 


COMMANDS 


BASIC 


COLS 


M - MOVE 






LINE 


I - INSERT 


C - COPY 






COMMANDS 


D - DELETE 
R - REPEAT 


A - AFTER 
B - BEFORE 






GENERAL 






LOCATE 


PRINT 


COMMANDS 






NUMBER 

RENUM 

UNNUM 

AUTONUM 

STATS 


RECOVERY 

RESET 

SUBMIT 

SAVE 

CANCEL 


FIND AND 






FIND 




CHANGE 






CHANGE 




ADVANCED 


MASK 


X - EXCLUDE 


COPY 


NULLS 


FEATURES 


< - DATA LEFT 


S - SHOW 


MOVE 


TABS 




> - DATA RIGHT 


F - FIRST 


CREATE 


PROFILE 




( - COLS LEFT 


L - LAST 


REPLACE 


HEX 




) - COLS RIGHT 


TABS 








BOUNDS 








TEXT 


TE - TEXT ENTRY 




CAPS 




PREPARATION 


TS - TEXT SPLIT 








FEATURES 


TF - TEXT FLOW 
- OVERLAY 









Figure 24. List of Edit Commands 
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Edit Modes and Profiles 

Edit is capable of operating in the following modes: 

NUMBER Mode - controls validation and generation of sequence 
numbers. 

AUTONUM Mode - controls automatic renumbering when the data 
i s saved. 

STATS Mode - controls generation of SPF library statistics. 

PRINT Mode - controls automatic recording of source listings 
in the SPF list file. 

CAPS Mode - controls translation of alphabetic characters to 
upper case. 

NULLS Mode - controls replacement of trailing blanks with 
null characters on the display screen. 

TABS Mode - controls use of "hardware" or "logical" tabs. 

HEX Mode - controls display of data in hexadecimal format. 

RECOVERY Mode - controls automatic recording of edit trans- 
actions to facilitate recovery following a system failure. 

Each mode may be turned on or off independently of the other modes 
by means of the following primary commands: NUMBER* AUTONUM, 
STATS, PRINT, CAPS, NULLS, TABS, HEX, and RECOVERY. See the com- 
mand descriptions for further explanation. 

The current settings of the modes, together with the current MASK, 
TABS, and BOUNDS lines, are maintained in an edit profile which 
may be displayed at any time via the PROFILE command. When edit 
is terminated, the current edit profile is automatically saved as 
part of the user profile. 

SPF maintains up to 25 different edit profiles for each user. 
This allows different mode settings and different MASK, TABS, and 
BOUNDS lines to be remembered and used as the initial settings for 
different types of source data. 

Each profile is normally associated with the data "type" (the SPF 
library type or CMS filetype). When the user edits COBOL data, for 
example, the default profile contains whatever modes were in 
effect the last time the user finished editing COBOL data. Addi- 
tional profiles may be created and used by specifying a profile 
name on the edit entry panel, or as an operand on the PROFILE com- 
mand. 

Listed below are the default mode settings when a new profile is 
generated (i.e., when the user edits a new type of data for the 
first time, or specifies a new profile name on the edit entry pan- 
el). If the user already has 25 edit profiles, the least recently 
used profile is automatically deleted when a new profile is genei — 
ated. 



NUMBER 


ON 


AUTONUM 


OFF 


STATS 


ON 


PRINT 


OFF 


CAPS 


ON 


NULLS 


OFF 


TABS 


OFF 


HEX 


OFF 



RECOVERY OFF 



Edit (Option 2) 43 



Three of the mode settings will be automatically 
appropriate* whenever data is fetched for editing: 



changed, if 



• NUMBER mode will be set on or off depending upon whether the 
data currently contains sequence numbers. 

• CAPS mode will be set on or off depending upon whether the 
data currently contains lower case alphabetics. 

• STATS mode will be set on if the member currently has SPF 
statistics. If STATS mode is already on and the member has no 
statistics, a caution message will be displayed but STATS 
mode will be left on. (STATS mode is ignored for CMS files.) 

A caution message is displayed whenever edit automatically 
changes one of these mode settings. The message is displayed in 
the first two lines of the data area. An example is shown in 
Figure 25. A caution message is also displayed if edit discovers 
invalid (non-di splayable) characters in the data. 

Caution messages may be removed from display by using the RESET 
primary command or by deleting the individual message lines using 
the "D" line command. Caution messages are never saved as part of 
the data. 







EDIT — SPFDEMO.MYLIB.PLKCOINS) - 01.04 

COMMAND INPUT ===> _ 

****** *************************** TOP OF DATA 

==MSS> -CAUTION- PROFILE CHANGED TO "NUMBER ON 

==MSG> DATA HAS VALID STANDARD NUMBERS. 

000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN)} 

000300 DECLARE 

000400 

000500 

000600 

000700 

000800 

000900 

001000 

001100 

001200 

001300 

001400 

001500 

001600 

001700 

001800 

001900 



COUNT 


FIXED BINARY (31) AUTOMATIC 


HALVES 


FIXED BINARY (31), 


QUARTERS 


FIXED BINARY (31), 


DIMES 


FIXED BINARY (31), 


NICKELS 


FIXED BINARY (31), 


SYSPRINT 


FILE STREAM OUTPUT PRINT; 


DO HALVES : 


= 100 TO BY -50; 



COLUMNS 001 072 

SCROLL ===> HALF 
******************************** 
STD" (FROM "NUMBER OFF"). 



INIT (l)i 



DO QUARTERS = (100 - HALVES) TO BY -25; 

DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY -10; 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 

PUT FILE( SYSPRINT ) DATA( COUNT, HALVES, QUARTERS, DIMES, NICKELS); 
COUNT - COUNT + 1; 
END; 
END; 
END; 
END COINS? 



****** *************************** BOTTOM OF DATA ***************************** 



Figure 25. Edit - Caution Message 
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Edit Termination 



) 



Normally, edit is terminated by pressing the End PF key, which 
causes the following actions: 

1. If any changes have been made to the data: 

• The data is renumbered if both NUMBER mode and AUTONUM 
mode are on. 

• The data is automatically saved — see description of 
SAVE command. 

Note : "Special" lines (MASK, TABS, COLS, BOUNDS, message 
lines, and profile display lines) are never saved as part 
of the data, and need not be deleted prior to issuing a 
SAVE command or pressing the End PF key. 

• The SPF statistics are updated (or generated if none pre- 
viously existed) if STATS mode is on and the data is a 
member of an SPF library. 

• A source listing of the data is recorded in the SPF list 
file for eventual printing if PRINT mode is on. 

2. A return is then made to the previous display (either the mem- 
ber selection list or the edit entry panel). When return is 
to the member selection list, the member just edited will 
appear at the top of the list. 

Note : The Return PF key, which is logically equivalent to 
repeated use of the End PF key, will also cause action (1) to 
occur. 

The user may save the data without terminating edit (and without 
printing) via the SAVE command. The user may also terminate edit- 
ing without saving (or printing) via the CANCEL command. 



) 
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BASIC LINE COMMANDS 



The following commands are described in this section: 



COLS (columns) 
I (insert) 
D (delete) 
R (repeat) 



(move) 
(copy) 
(after) 
(before) 



These are all "line" commands, entered by overtyping the 6-digit 
number in the line command area on one or more lines. 



Identifying Columns 



A column identification line may be displayed by entering the 



characters "COLS" 
the line number. 



or "COL" in the line command area, overtyping 



COLS 



Display column identification line 



Command abbreviation: COL 



When the ENTER key is pressed, a special line is inserted at the 
designated position and the remaining lines are pushed down by one 
line position. An example of the COLS line is shown in Figure 26. 



) 



> 



EDIT SPFDEMO.MYLIB.PLK COINS) - 01.04 COLUMNS 001 072 

COMMAND INPUT ===> _ SCROLL ===> HALF 

****** *************************** TOP OF DATA ******************************** 

000100 COINS: 

000200 PROCEDURE OPTIONS (MAIN); 

000300 DECLARE 

000400 COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 

000500 HALVES FIXED BINARY (31), 

000600 QUARTERS FIXED BINARY (31), 

=COLS> + 1 +——2 + 3 + 4 + 5 + 6 + 7— 

000700 DIMES FIXED BINARY (31), 

000800 NICKELS FIXED BINARY (31), 

000900 SYSPRINT FILE STREAM OUTPUT PRINT; 

001000 DO HALVES = 100 TO BY -50; 

001100 DO QUARTERS = (100 - HALVES) TO BY -25; 

001200 DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY -10 J 

001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001400 PUT FILE (SYSPRINT) DATA(COUNT, HALVES, QUARTERS, DIMES, NICKELS); 

001500 COUNT = COUNT + 1; 

001600 END; 

001700 END; 

001800 END; 

001900 END COINS; 

****** *************************** BOTTOM OF DATA ***************************** 



) 



Figure 26. Edit - Column Identification Line 
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Note ; Unlike browse* COLS is a line command* not a primary command 
(it may not be entered in the command input field on line 2). 

The column identification line may be removed from display by 
entering a "D" in the line command area, or by entering a RESET 
primary command. The column identification line is never saved as 
part of the data. 



Inserting and Deleting Lines 



To insert a line, the single character "I" is entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, a new line is inserted immediately following the line 
containing the "I". A number may follow the "I" to indicate that 
more than one line is to be inserted. For example, "13" would 
cause three new lines to be inserted. 



I - Insert line 

In - Insert "n" lines 



If any information is entered on an inserted line (even a blank 
character), the line becomes part of the source data and is 
assigned a line number the next time the ENTER key is pressed. If 
no information is entered on an inserted line, the line is auto- 
matically deleted the next time the ENTER key is pressed. If 
information is entered on the last (or only) inserted line and if 
the cursor is still in the data portion of that line when ENTER is 
pressed, another new line is automatically inserted following 
that line. This allows line after line of data to be generated in 
a "continuous insert" mode. 

To delete a line, the single character "D" is entered in the line 
command area, overtyping the line number. A number may follow the 
"D" to indicate that more than one line is to be deleted. For 
example, "D99999" would cause all remaining lines to be deleted, 
starting with the line containing the "D99999". 



D - Delete line 

Dn - Delete "n" lines 

DD - Delete block of lines 



To delete a block of lines, the double character "DD" i s entered 
in the line command area of the first and last lines to be 
deleted. The first and last line need not be on the same page; 
scrolling may be used between entering the first "DD" and the sec- 
ond "DD". 

Figure 27 shows a bef ore-and-af ter example of line insertion and 
deletion. Three new lines ar& inserted after line 800 and line 
1400 is deleted. 
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EDIT — SPFDEMO.MYLIB.PLKCOINS) - 01.04 

COMMAND INPUT ===> 

****** *************************** TOP OF DATA 
COINS: 

PROCEDURE OPTIONS (MAIN); 
DECLARE 



COLUMNS 001 072 

SCROLL ===> HALF 
******************************** 



000100 

000200 

000300 

000400 

000500 

000600 

000700 

13 

000900 

001000 

001100 

001200 

001300 

D _ 

001500 

001600 

001700 

001800 

001900 



COUNT FIXED BINARY 
HALVES FIXED BINARY 
QUARTERS FIXED BINARY 
DIMES FIXED BINARY 
NICKELS FIXED BINARY 
SYSPRINT FILE STREAM OUTPUT PRINT; 
DO HALVES = 100 TO BY -50; 



(31) AUTOMATIC INIT (1), 

(31), 

(31), 

(31), 

(31), 



105 



DO QUARTERS = (100 - HALVES) TO BY -25; 

DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 

PUT FILE (SYSPRINT) DATA(COUNT, HALVES, QUARTERS, DIMES, NICKELS) ; 
COUNT = COUNT + 1; 
END; 
END; 
END; 
END COINS; 



****** *************************** BOTTOM OF DATA ***************************** 



>) 



D> 



> 



EDIT — SPFDEMO.MYLIB.PLKCOINS) - 01.04 COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===> HALF 

****** *************************** TOP OF DATA ******************************** 



000100 


COINS: 




000200 


PROCEDURE OPTIONS (MAIN); 




000300 


DECLARE 




000400 


COUNT FIXED BINARY 


(31) AUTOMATIC INIT (1), 


000500 


HALVES FIXED BINARY 


(31), 


000600 


QUARTERS FIXED BINARY 


(31), 


000700 


DIMES FIXED BINARY 


(31), 


000800 


NICKELS FIXED BINARY 


(31), 



I • I I I I 

000900 SYSPRINT FILE STREAM OUTPUT PRINT; 

001000 DO HALVES = 100 TO BY -50; 

001100 DO QUARTERS = (100 - HALVES) TO BY -25; 

001200 DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY -10; 

001300 NICKELS = 100 - HALVES - QUARTERS - DIMES; 

001500 COUNT = COUNT + 1; 

001600 END; 

001700 END; 

001800 END; 

001900 END COINS; 

****** *************************** BOTTOM OF DATA ***************************** 



1 



Figure 27. Edit - Insert and Delete Lines Example 
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Repeating lines 



To repeat a line, the single character "R" is entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, a duplicate copy of the line is inserted immediately fol- 
lowing the line containing the "R". A number may follow the "R" 
to indicate that the line is to be repeated more than one time. 
For example, "R5" would cause five identical copies of the line to 
be inserted. 



R 


- Repeat 


1 i ne 




Rn 


- Repeat 


line "n" 


times 


RR 


- Repeat 


block of 


lines 


RRn 


- Repeat 


block of 


lines "n" times 



To repeat a block of lines, the double character "RR" is entered 
in the line command area of the first and last lines to be 
repeated. The first and last lines need not be on the same page. 
A number may follow the "RR" on either the first or last lines (or 
both) to indicate that the block of lines is to be repeated more 
than one time. 

Suppose, for example, the following code i s to be generated: 



DECLARE 

I FIXED BINARYC31), 
J FIXED BINARYC31), 
K FIXED BINARYC31), 
L FIXED BINARYC31); 



/* WORK COUNTER */ 
/x WORK COUNTER */ 
/* WORK COUNTER */ 
/* WORK COUNTER */ 



The easiest way to generate this code is to type the first two 
lines, repeat the second line three times, then move the cursor to 
each of the repeated lines and make the necessary changes. A 
before-and-after illustration of the repeat command is shown in 
Figure 28. 
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> 



EDIT SPFDEMO.MYLIB.PLKDCLS) - 01.00 COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===> HALF 

****** *************************** TOP OF DATA ******************************** 



000100 
000200 

000400 
000500 
000600 
000700 
000800 
000900 
001000 
001100 
001200 
001300 
001400 
001500 
001600 
001700 
001800 
001900 
002000 



/* 



SEGMENT 

DECLARE 
I 

DECLARE 
COUNT 
HALVES 
QUARTERS 
DIMES 
NICKELS 
SYSFRINT 

DO HALVES = 



'DCLS* — INCLUDED FROM SEGMENT 'MAIN* 



FIXED BINARY(31), 



/* WORK COUNTER 



*/ 



*/ 



FIXED BINARY 
FIXED BINARY 
FIXED BINARY 
FIXED BINARY 
FIXED BINARY 
FILE STREAM OUTPUT PRINT; 
100 TO BY -50; 



(31) AUTOMATIC INIT (1), 

(31), 

(31), 

(31), 

(31), 



DO QUARTERS = (100 - HALVES) TO BY -25; 

DO DIMES = ((100 - HALVES - QUARTERS )/10 )*10 TO BY -10; 
NICKELS = 100 - HALVES - QUARTERS - DIMES; 

PUT FILE (SYSPRINT) DATA( COUNT, HALVES, QUARTERS, DIMES, NICKELS); 
COUNT = COUNT + 1; 
END; 
END; 
END; 
END COINS; 



****** *************************** BOTTOM OF DATA ***************************** 





EDIT — 


- SPFDEMO.MYLIB.PLKDCLS) - 01.00 COLUMNS 001 072 




COMMAND 


INPUT ===> SCROLL ===> HALF 




****** 


*************************** TOP OF DATA ******************************** 




000100 


/* SEGMENT 'DCLS' — INCLUDED FROM SEGMENT 'MAIN* */ 


> 


000200 


DECLARE 


000300 


I FIXED BINARY(31), /* WORK COUNTER */ 


000310 


I FIXED BINARY(31), /* WORK COUNTER */ 


D> 


000320 


I FIXED BINARY(31), /* WORK COUNTER */ 


000330 


I FIXED BINARY(31), /* WORK COUNTER */ 




000400 


DECLARE 




000500 


COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 




000600 


HALVES FIXED BINARY (31), 




000700 


QUARTERS FIXED BINARY (31), 




000800 


DIMES FIXED BINARY (31), 




000900 


NICKELS FIXED BINARY (31), 




001000 


SYSPRINT FILE STREAM OUTPUT PRINT; 




001100 


DO HALVES = 100 TO BY -50; 




001200 


DO QUARTERS = ( 100 - HALVES) TO BY -25; 




001300 


DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY -10; 




001400 


NICKELS = 100 - HALVES - QUARTERS - DIMES; 




001500 


PUT FILE (SYSPRINT) DATA(COUNT, HALVES, QUARTERS, DIMES, NICKELS); 




001600 


COUNT = COUNT + 1; 




001700 


END ; 




001800 


END; 




001900 


END; 




002000 


END COINS; 




****** 


*************************** BOTTOM OF DATA ***************************** 



i 



Figure 28. Edit - Repeat Line Example 
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Moving and Copying Lines 

To move a line, the single character "M" is entered in the line 
command area of the line to be moved, and the character "A" (af- 
ter) is entered in the line command area of another line, indicat- 
ing the destination of the move. When the ENTER key is pressed, 
the line containing the "M" is moved immediately following the 
line containing the "A". Alternatively, the destination may be 
indicated with a "B" (before) line command, in which case the line 
containing the "M" is inserted immediately preceding the line 
containing the "B". 



M - Move line 

Mn - Move "n" lines 

MM - Move block of lines 



C - Copy line 

Cn - Copy "n" lines 

CC - Copy block of lines 



A 


- After this line 


An 


- After this line and repeat "n" times 


B 


- Before this line 


Bn 


- Before this line and repeat "n" times 



A number may follow the "M" to indicate that more than one line is 
to be moved. A block of lines to be moved is indicated by entei — 
ing the double character "MM" on the first and last lines to be 
moved. The first and last lines to be moved, and the destination 
line may all be on separate pages. 

A number may also follow the "A" or "B" line command to cause the 
moved line(s) to be repeated the designated number of times at the 
point of destination. 

The procedure for copying lines is the same as for moving lines, 
except that a "C" or "CC" line command is used in place of the "M" 
or "MM". The copy operation leaves the original line(s) in place, 
and makes a duplicate copy at the indicated destination 



es a uu^x i bct^t! tuny ei *. v-iie inuibaieu UK3i.iiiai.iuM. 

29 shows a bef ore-and-af ter example of copying lines. The 
>f lines starting at line 800 through line 1500 is copied to 
line 1900. 



Figure 29 shows 
block o " " " 
follow 
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> 





EDIT ~ 

COMMAND 

000700 

CC 

000900 

001000 

001100 

001200 

001300 

001400 

CC 

001600 

001700 

001800 

A_ 

002000 

002100 

002200 

****** 



COLUMNS 001 072 
SCROLL ===> HALF 



■ SPFDEMO.MYLIB.PLK TESTDIR) - 01.03 

INPUT ===> 

IF ERROR-FLAG THEN 
DO; 

PUT FILE(SYSPRINT) 

EDITCTEST NOTES ERROR RETURN FROM D-I-R') 
(C0LUMN(21),A(34)); 
PUT FILE(SYSPRINT) SKIP(2) 

DATA( ERROR-FLAG, CARD-IMAGE , ANSWER ) ; 
ERROR-FLAG = 'O'B; 
END; 
ELSE 

END; 
ELSE 

; 
END; 
END TESTDIR; 
*************************** BOTTOM OF DATA ***************************** 





EDIT — 


- SPFDEMO.MYLIB. 


PLKTESTDIR) - 01.03 COLUMNS 001 072 




COMMAND 


INPUT 


===> 


SCROLL ===> HALF 




000700 




IF ERROR-FLAG THEN 




000800 




DO; 






000900 




PUT 


FILE(SYSPRINT) 




001000 






EDITCTEST NOTES ERROR RETURN FROM D-I-R') 




001100 






(C0LUMN(21),A(34)); 




001200 




PUT 


FILE(SYSPRINT) SKIP(2) 




001300 






DATA( ERROR-FLAG, CARD-IMAGE > ANSWER ) ; 




001400 




ERROR-FLAG = 'O'B; 




001500 




END; 






001600 




ELSE 






001700 




; 






001800 




END; 







001900 


ELSE 




001910 




DO; 




001920 




PUT 


FILE(SYSPRINT) 




001930 






EDITCTEST NOTES ERROR RETURN FROM D-I-R') 




001940 






< COLUMN* 21 ),A( 34)); 




001950 




PUT 


FILE(SYSPRINT) SKIP(2) 




001960 






DATA( ERROR-FLAG, CARD-IMAGE, ANSWER); 


> 


001970 




ERROR-FLAG = 'O'B; 


001980 




END; 




002000 




» 






002100 


ENDi 








002200 


END TESTDIR; 






****** 


*************************** BOTTOM OF DATA ***************************** 



I 



Figure 29. Edit - Copy Lines Example 
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Rules for Entering Line Commands 

The following rules apply to all edit line commands. 

Several line commands as well as data modifications may be typed 
before pressing the ENTER key. Error messages will be displayed 
in cases where multiple line commands are ambiguous. If an erro- 
neous or unwanted line command is entered, it may be undone by 
simply blanking it out or by using the RESET primary command. 

In most cases, only the first one or two characters of the line 
number need be overtyped to enter a line command. For example, if 
line 700 i s to be repeated, a single "R" may be typed: 

0006 
R00700 
000800 

In some cases, however, typing a single character may be ambig- 
uous. In the following example, it is unclear whether the user 
has typed a single "R" to repeat line 31700, or "R3" to repeat the 
line three times. 

031600 
R31700 
031800 

In such cases, edit assumes that the user has not entered a number 
following the line command. If the user meant to repeat the line 
three times, he may use any of the following procedures. 

1. Leave the cursor on the character immediately following the 
"R3": R317O0 

2. Type one or more blanks following the "R3": R3 700 

3. Type one or more blanks following the "R" but before the 
number: R 3700 

4. Type "R3" and then press the ERASE EOF key to clear the rest 
of the line command field, or press ERASE EOF first and then 
type "R3". 

Three line commands may be entered on the "TOP OF DATA" line by 
overtyping the asterisks which normally appear in its line com- 
mand field. They are: 

I or In - to insert lines ahead of the rest of the data. 

A or An - to move or copy lines ahead of the rest of the data. 

TE or TEn - to enter text lines ahead of the rest of the data. 

One line command may be entered on the "BOTTOM OF DATA" line by 
overtyping the asterisks, namely: 

B or Bn - to move or copy lines following the rest of the data. 

Hints on use of cursor keys: Use the NEW LINE key to move the cui — 
sor to the line command area of the next line. If the cursor is in 
a line command area, use the TAB FORWARD key to space over to the 
data field. 

Note : When a line command or data modification i s typed and the 
ENTER key is pressed, edit will frequently reposition the cursor 
to another line number or to another location within the data. 
Edit attempts to guess the most appropriate posi ti on f or the cui — 
sor, based on the previous user action. To assist the user in 
locating the cursor, edit intensifies the line number field on the 
line that contains the cursor. 
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GENERAL COMMANDS 



The following commands are described in this section: 

LOCATE AUTONUM RESET 

NUMBER STATS SUBMIT 

RENUM PRINT SAVE 

UNNUM RECOVERY CANCEL 

These are all "primary" commands, entered in the command input 
field on line 2. 



Locating Lines 



The LOCATE command performs up or down scrolling, as required, to 
a specified line number. If the specified line is not found, 
scrolli ng i s to the line which precedes the specified line number. 
Format: 



LOCATE line-number 



Command abbreviations: LOC, L 



The "line-number" operand is a numeric value of up to 8 digits 
(leading zeros need not be typed). If the operand contains 6 or 
fewer digits, it refers to the numbers in the line command fields, 
displayed at the left of each line. (For numbered data, these 
fields reflect the sequence numbers in the data records. For 
unnumbered data, these fields show relative line numbers.) If the 
line-number operand contains 8 digits, it refers directly to the 
sequence numbers in the data records, including the "modification 
flag" for SPF libraries (see below). 



Sequence Number Generation and Control 

When operating in NUMBER mode, edit automatically generates 
sequence numbers in the data for new lines that are created by 
insert or copy operations, and automatically renumbers the data 
when it is saved (provided AUTONUM mode is also in effect). 



Sequence Number Format 



| 



Sequence numbers may be generated in the "standard" sequence 
field, the COBOL sequence field, or both. The standard sequence 
field is either the last 8 characters of the data (for fixed 
length records) or the first 8 characters of the data (for vari- 
able length records), regardless of the programming language. 
The COBOL sequence field is always the first 6 characters of the 
data, and is valid only for fixed length records. 

For members of partitioned data sets, the format of standard 
sequence numbers is dependent on whether SPF statistics are being 
generated. If STATS mode is in effect, standard sequence numbers 
are 6 digits in length, followed by a 2-digit modification flag. 
The flag reflects the modification level of the member when the 
line was created or last changed. If, for example, a sequence 
number field contains 00040002, the line was added or last changed 
at modification level 02. The sequence number is 000400. When a 
new member is created with SPF statistics, the flags are all set 
to 00, since the modification level is initialized to zero. 
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If STATS mode is off, or if a is being edited, standard sequence 
numbers are 8 digits in length (right justified within the field). 
COBOL sequence numbers are always 6 digits in length, and are 
unaffected by the setting of STATS mode. 

Sequence numbers normally start at 100 and are incremented by 100. 
When inserting lines, edit will drop down to the tens or units 
position and, if necessary, renumber one or more succeeding lines 
to keep the sequence numbers in order. 



Sequence Number Display 



For numbered data, the edit line command fields (displayed at the 
left of each line) reflect the contents of the sequence numbers in 
the data. Normally the sequence numbers themselves are not dis- 
played, but the user may view them via left or right scrolling. 

The user may increase the width of the edit "window" to include 
the sequence numbers via the DISPLAY operand on the NUMBER or 
RENUM command. The difference will be noticeable only if the width 
of the data is less than the available width of the screen. 

Example : 

Suppose the data to be edited is fixed format, logical record 
length 100. It has both COBOL sequence numbers in the first 6 
columns, and standard sequence numbers in the last 8 columns. 
The data width, excluding sequence numbers, is thus 86 chai — 
acters (in columns 7 through 92). 

On a 3278 Model 5, which has an available screen width of 132, 
the default format is as follows: Each line will start with 
the 6-character line command field, followed by a data window 
that is 86 characters wide. Remaining positions beyond the 
window will be protected and blank. 

Upon initial display, columns 7-92 of the data will be shown 
in the 86-character window. The sequence numbers in the data 
will not be displayed. The user may display the numbers via a 
left or right scroll, but the window will remain 86 characters 
wide. If the user enters a NUMBER or RENUM command with the 
DISPLAY operand, the width of the window will be changed to 
100 characters, and the sequence numbers in the data will be 
displayed. 



Initialization of NUMBER Mode 

As data is fetched for editing, it is examined to determine 
whether or not it contains sequence numbers. The standard 
sequence field is always examined. The COBOL sequence field is 
also examined if the data set "type" (lowest level qualifier in 
the data set name) is COBOL. 

If all lines contain numeric characters in either the standard or 
COBOL sequence field positions (or both), and if the numbers are 
in ascending order, edit assumes the data is numbered and turns on 
NUMBER mode. Otherwise, edit turns off NUMBER mode. 

If the initial setting of NUMBER mode differs from the previous 
setting in the profile, a message will be di splayed indicating 
that edit has changed the mode. For new members or empty sequen- 
tial data sets, the initial setting of NUMBER mode is unchanged 
from whatever is specified in the profile. The default for a new 
profile is NUMBER mode ON for standard sequence fields, and for 
COBOL fields if the data set type is COBOL. 
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Controlling Sequence Numbering 

NUMBER mode may be turned on or off by using the NUMBER command. 
Format: 



NUMBER C0N/0FF3 CSTD] [COBOL] [DISPLAY] 



Command abbreviation: NUM 
Keyword abbreviation: COB 



(for COBOL) 



The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. The STD, COBOL, and DISPLAY operands 
are interpreted only when NUMBER mode is turned on. 

If STD is specified, the data will be numbered in the standard 
sequence field. If COBOL is specified, the data will be numbered 
in the COBOL field. If both STD and COBOL are specified, the data 
will be numbered in both fields. If both operands are omitted, 
the default is STD unless NUMBER mode was already in effect, in 
which case the data will be numbered in whichever field(s) were 
previously being numbered. 

Note : If both STD and COBOL numbers are being generated, the STD 
number is determined and then used as the COBOL number. This can 
result in COBOL numbers which are out of sequence if the COBOL and 
STD fields are not synchronized. Use the RENUM command (see 
below) to force synchronization. 



If the DISPLAY operand 
will include the sequence 
Display"). Otherwise, the 
sequence number fields. 



is specified, the width of the data window 
number fields (see "Sequence Number 
width of the window will exclude the 



When NUMBER mode is turned on, the NUMBER command verifies that 
all lines have valid numbers that are in ascending sequence. It 
renumbers any lines that are either unnumbered or out of sequence, 
but does not otherwise alter existing sequence numbers. 



Three additional commands, RENUM, UNNUM, and AUTONUM, 
able to assist with number generation and control. 



are avai 1- 



The RENUM command immediately renumbers all lines, starting with 
number 100 and incrementing by 100, and also turns on NUMBER mode. 
Format: 



RENUM CSTD3 [COBOL] [DISPLAY] 



Command abbreviation: REN 
Keyword abbreviation: COB 



(for COBOL) 



The meaning of the STD, COBOL, and DISPLAY operands is the same as 
for the NUMBER command. 

The UNNUM command sets all sequence fields to blanks and also 
turns off NUMBER mode. It is valid only when NUMBER mode is cur- 
rently on. The fields to be blanked are either the standard 
sequence field, the COBOL sequence field, or both, depending what 
was previously being numbered prior to issuing the UNNUM command. 
Format: 



UNNUM 



Command abbreviation: UNN 



> 



The UNNUM command uses no operands. 
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The AUTONUM command controls the setting of AUTONUM mode. When 
this mode is on, the data is automatically renumbered whenever it 
is saved, provi ded NUMBER mode is also on at that time. 

AUTONUM mode may be turned on or off by using the AUTONUM command. 
Format: 



AUTONUM C0N/0FF3 



If the operand is omitted, ON is the default. 



Statistics Generation 



Generation of SPF statistics for a member of a partitioned data 
set is controlled by STATS mode. If STATS mode is on when the 
member is saved, the statistics will be updated (or created if the 
member did not previously have statistics) and stored in the "us- 
er" portion of the directory entry for that member. If STATS mode 
is off when the member is saved, no statistics are stored and any 
previous statistics are destroyed. STATS mode is ignored for 
sequential data sets. 

STATS mode may be turned on or off by using the STATS command. 
Format: 



STATS [ON/OFF] 



If the operand is omitted, ON is the default. 

Whenever a member i s fetched for editing, SPF will check the set- 
ting of STATS mode. If STATS mode is off and the member has sta- 
tistics, SPF will automatically turn on STATS mode and display a 
message indicating that the mode has been changed. If STATS mode 
is on and the member has no statistics, a warning message will be 
displayed but the mode will remain unchanged. 

When a new member is created, the initial setting of STATS mode is 
unchanged from whatever is in the profile. The default for a new 
profile is STATS mode ON. 

The generation of SPF statistics also affects the format of 
sequence numbers, as discussed under "Sequence Number Generation 
and Control". 



Automatic Source Listings 

The automatic generation of source listings is controlled by 
PRINT mode. If this mode is on when edit is terminated via the End 
or Return PF key, and if the data has been changed, a source list- 
ing of the data will be recorded in the SPF list data set for 
eventual printing. 

PRINT mode may be turned on or off by using the PRINT command. 
Format: 



PRINT [0N/0FF3 



If the operand is omitted, ON is the default. 
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Recovery Control 



When edit is operating in RECOVERY mode* an audit trail of user 
interactions is automatically recorded in an SPF-controlled data 
set. Following a system failure, the recovery data set may be used 
to replay the edit session. When edit is selected from the prima- 
ry option menu, a special menu is displayed indicating that recov- 
ery is available (Figure 30). As directed on the menu, the user 
may proceed with recovery, cancel recovery, or press the End PF 
key to return to the primary option menu. 

RECOVERY mode may be turned on or off by using the RECOVERY com- 
mand. Format: 



RECOVERY [ON/OFF] 



Command abbreviation: REC 



If the operand is omitted, ON is the default. 

Operating with RECOVERY mode off may result in improved response 
time due to the elimination of I/O operations to maintain the 
recovery data set. If RECOVERY mode is on, the first change to 
the data causes a checkpoint of the data to be written. This may 
increase response time for the interaction, especially if a large 
member or sequential data set is being edited. 



EDIT _ RECOVERY 

SELECT OPTION ===> _ 

***************************************** 
* EDIT AUTOMATIC RECOVERY * 

***************************************** 

SPFDEMO.XXX.COBOU CBLMAIN ) 

WAS BEING EDITED WHEN A SYSTEM FAILURE OR SPF ABEND OCCURRED. 

INSTRUCTIONS: 

PRESS ENTER TO CONTINUE THE EDIT SESSION, OR 

PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU, OR 

ENTER CANCEL ABOVE TO CANCEL RECOVERY OF THE EDIT 
SESSION AND PROCEED TO THE EDIT ENTRY PANEL. 



IF YOU WISH TO PRESS ENTER AND THE MINIDISK IS PASSWORD PROTECTED, SPECIFY: 
READ PASSWORD ===> UPDATE PASSWORD ===> 



I 



Figure 30. Edit - Recovery Menu 
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General Reset 



Edit will display warning messages in the data portion of the dis- 
play if a mode setting has been automatically changed by edit 
after examination of the data, or if the data contains invalid 
characters. Edit also displays line messages to show the current 
setting of edit modes (when the PROFILE command is entered). Dis- 
play of messages and other special conditions may be reset by 
using the RESET command. Format: 



RESET 



Command abbreviation: RES 



No operands are used for this command. 

The RESET command will: terminate display of all message lines 
and other special lines (COLS, MASK, TABS, and BOUNDS), reset line 
numbers to normal after they were replaced with "==CHG>" or 
"==ERR>" messages (see CHANGE and shift commands), blank out 
erroneous or unwanted line commands, and redisplay all excluded 
lines. The RESET command does not change any of the edit modes, 
nor alter the data. 

Note : RESET scans every line of data for conditions to be reset. 
Use of the "D" line command to delete one or more special lines 
may result in faster response time. 



Submit to Job Stream 



The SUBMIT command may be used to submit the data being edited 
(entire member or file) to the job stream of another VM machine. 
Format: 



SUBMIT machine-id 



Command abbreviation: SUB 



The operand is required to specify the VM machine to which the 
data is being submitted. It may specify a CMS batch machine, or a 
VS or DOS machine. 

Note : SPF does not supply a job statement when the edit SUBMIT 
command is invoked. The user may supply job statement(s) as part 
of the data being submitted. 



Save and Cancel 



The SAVE command may be used to save the edited data without ter- 
minating edit, and the CANCEL command may be used to terminate 
edit without saving the data. Formats: 



SAVE 




CANCEL 


Command abbreviation: 


CAN 



No operands are used for these commands, 
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% 



} 



) 



Note ; As a general rule, use of the SAVE command is not necessary 
if RECOVERY mode is on. 

The SAVE command writes the data back to the same data set from 
where it was fetched, except when a concatenated sequence of pai — 
titioned data sets has been specified. In this case, the data is 
saved in the first library of the concatenation sequence regard- 
less of which library it came from. For a sequential data set, 
the entire data set is rewritten. For a partitioned data set, the 
member is rewritten with the same member name, and the library 
statistics for the member are automatically updated (provided 
STATS mode is in effect). 

The data is automatically renumbered prior to saving, provided 
both NUMBER mode and AUTONUM mode are in effect. 

If SAVE cannot successfully rewrite the data due to I/O errors or 
insufficient space in the data set, a message is displayed in the 
upper right-hand corner of the screen, accompanied by an audible 
alarm (if installed). The user may then attempt to save the data 
in another data set by taking the following steps: 

1. Enter a CREATE or REPLACE command with no operand on the pri- 
mary command line. (CREATE may be used only if the destina- 
tion is a partitioned data set.) 

2. Enter "C99999" or "M99999" on the first data line, indicating 
that all lines are to be copied or moved. Then press the 
ENTER key. 

3. Fill in the data set (and member) name on the CREATE or 
REPLACE menu, and press the ENTER key. 

See CREATE and REPLACE commands for further information. 

Alternatively, the user may wish to enter split screen mode and 
attempt to fix the problem by using appropriate utilities, e.g., 
compress (for a partitioned data set) or delete and reallocate 
(for a sequential data set), and then retry the save from the edit 
screen. 

The normal way to terminate edit is by pressing the End or Return 
PF key, which causes the following actions. 

1. A SAVE is issued if any changes have been made since the data 
was last saved. (The above discussion of I/O errors also pel — 
tains to an automatic SAVE when the End or Return key is 
pressed.) 

2. If any saves have occurred, the data is recorded in the SPF 
list data set (provided PRINT mode is in effect). 



3. Editing is then terminated. 



Note : Neither the SAVE nor CANCEL command causes automatic 
recording in the SPF list data set, regardless of the setting of 
PRINT mode. 
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FINDING AND CHANGING CHARACTER STRINGS 

The following commands are described in this section: 

FIND 
CHANGE 

These &re both "primary" commands, entered in the command input 
f i eld on li ne 2. 

The FIND command is used to find one or more occurrances of a 
specified character string, and the CHANGE command is used to 
change one or more occurrences to another character string. Both 
commands allow special forms of character strings and several 
optional parameters to control: 

• Starting point and direction of search 

• Special conditions to control character string "match" 

• Range and column limitations on extent of search 

The command summary, which follows, describes the basic forms of 
FIND and CHANGE which are most frequently needed. The remainder 
of this section provides detailed information about the various 
special features and options. 



Command Summary 

The basic format for FIND and CHANGE is: 



FIND string-1 [ALL] 



Command abbreviation: F 



CHANGE string-1 string-2 CALL] 



Command abbreviations: CHG, C 



The operands may be separated by blanks or commas. The ALL opei — 
and is optional, and may precede or follow either string. 

As a general rule, the strings are typed without delimiters. 
Examples: 

FIND XYZ 

CHANGE ALL ABC IJKL 

to find the next occurrence of XYZ or to change all occurrences of 
ABC to IJKL. 

Strings may be delimited with either apostrophes ( * ) or quotation 
marks ("). Delimiters must be used if a string contains imbedded 
blanks or commas, or if a string is the same as a command keyword. 
Examples: 

FIND 'EVERY ONE* 

CHANGE 'EVERY ONE* 'ALL* 

to find the next occurrence of "EVERY ONE" or to change the next 
occurrence of "EVERY ONE" to "ALL". 
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) 



If the ALL operand is omitted, the FIND or CHANGE command searches 
for the next occurrence of string-1 starting at the current cursor 
location. (If the cursor is not in the data area of the screen, 
scanning starts at the beginning of the first line which is cui — 
rently being displayed.) Scrolling is performed, if necessary, 
to bring the string into view. The cursor is positioned under the 
string (for a CHANGE command, it is positioned at the end of the 
changed string) and a verification message is displayed in the 
upper right-hand corner of the screen. The Find or Change PF key 
may be used to find or change each successive occurrence of the 
string. 

If the string is not found between the current cursor location and 
the end of data, a "BOTTOM OF DATA REACHED" message is displayed 
and the audible alarm is sounded (if installed). The Find or 
Change PF key may then be used to wrap to the top of data and con- 
tinue searching. If the string is not found anywhere in the data 
a "NO xxxxx FOUND" message is displayed. 

If the ALL operand is typed, the FIND or CHANGE command searches 
for all occurrences of string-1 starting at the top of the data, 
and positions the cursor under the first occurrence. The verifi- 
cation message indicates the number of occurrences found. For a 
CHANGE command, each line on which a change occurred is indicated 
with a "==CHG>" message in the line number field. 

If the two strings specified for a CHANGE command sre not the same 
length, automatic shifting is performed by expanding or collaps- 
ing multiple blank characters to the right of the substitution. 
In no case is data lost. If insufficient blanks exist for 
right-shifting, the original string remains unchanged. This con- 
dition is indicated with a "==ERR>" message in the line number 
field. 

Following a CHANGE command, the ==CHG> and ==ERR> line messages 
may be reset to normal via the RESET command, or by overtyping the 
line number or data on those lines. 

The Find and Change PF keys may be used together to find each 
occurrence of a character string, examine it, and then either 
change it (by pressing the Change PF key), or go on to the next 
occurrence (by pressing the Find PF key). To do this, start by 
typing a CHANGE command on line 2 but then, rather than pressing 
ENTER, press the Find PF key. This will position the cursor to 
string-1 without changing it. Then press Change (to change it to 
string-2) or Find (to get to the next occurrence of string-1). 

Figure 31 shows a before-and-af ter example of the CHANGE comand. 
All occurrences of the character string NUMERIC are replaced with 
the string NUMERIC-INT. The cursor is repositioned to the end of 
the first occurrence, and a ==CHG> message is displayed at the 
beginning of each changed line. 
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> 



EDIT — 


- CBLMAIN COBOL Al — — COLUMNS 007 


078 


COMMAND 


INPUT ===> CHG NUMERIC NUMERIC-INT ALL_ SCROLL ===> 


HALF 


003300 


DATA RECORD IS O-C. 




003400 


01 O-C. 




003500 


02 DUMMY PICTURE X(80). 




003600 


WORKING-STORAGE SECTION. 




003700 


77 OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 




003800 


77 PREV-DEVICE-TYPE-CODE PICTURE X VALUE 'I'. 




003900 


77 PREV-ACTV-CODE PICTURE 9 VALUE 0. 




004000 


77 PREV-PROB-CODE PICTURE 9 VALUE 0. 




004100 


77 C-SWITCH PICTURE X VALUE 'O*. 




004200 


77 PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 




004300 


77 GSA-REF PICTURE XX. 




004400 


77 UNIT-PRICE-NUMERIC PICTURE S9(8)V99. 




004500 


77 BML-NUMERIC PICTURE S9(8)V99. 




004600 


77 PREV-MODEL PICTURE X(5) VALUE '0'. 




004700 


77 PG-COUNT PICTURE 999 VALUE 0. 




004800 


77 PERIOD PICTURE 99 VALUE 0. 




004900 


77 PL-TOTAL-PRICE-NUMERIC PICTURE S9(8)V99 VALUE 0. 




005000 


77 PL-TOTAL-BMR-NUMERIC PICTURE S9(8)V99 VALUE 0. 




005100 


77 PL-MAINT-REQ-NUM PICTURE S9(4)V99 VALUE 0. 




005300 


77 HEADING-SW PICTURE 9 VALUE 1. 




005400 


77 PREV-DEVICE PICTURE X(6) VALUE SPACES. 




005500 


77 PREV-RPQ-FEATURE PICTURE X(10) VALUE SPACES. 




005600 


77 TEMP-MAINT PICTURE S9(7)V99 VALUE 0. 




005700 


77 TOTAL-BMR PICTURE S9(8)V99 VALUE 0. 




005800 


77 TOTL-PR PICTURE S9(8)V99 VALUE 0. 




005900 


77 TOTAL-MAINT PICTURE S9(7)V99 VALUE 0. 







EDIT — 
COMMAND 




CHANGED 
=> HALF 




INPUT : 


:==> SCROLL == 




003300 




DATA RECORD IS O-C. 






003400 


01 


O-C. 






003500 




02 


DUMMY PICTURE X(80). 






003600 


WORKING-STORAGE SECTION. 






003700 




77 


OP-SUB PICTURE S99 COMPUTATIONAL VALUE 0. 






003800 




77 


FREV-DEVICE-TYPE-CODE PICTURE X VALUE 'I'. 






003900 




77 


PREV-ACTV-CODE PICTURE 9 VALUE 0. 






004000 




77 


PREV-FR03-C0DE PICTURE 9 VALUE 0. 






004100 




77 


C-SWITCH PICTURE X VALUE '0'. 






004200 




77 


PREV-SYSTEM-CODE PICTURE X VALUE SPACE. 






004300 




77 


GSA-REF PICTURE XX. 




> 


==CHG> 
==CHG> 




77 
77 


UNIT-PRICE-NUMERIC-INT PICTURE S9(8)V99. 
BML-NUMERIC-INT PICTURE S9(8)V99. 






004600 




77 


PREV-MODEL PICTURE X(5) VALUE 'O'. 






004700 




77 


PG-COUNT PICTURE 999 VALUE 0. 






004800 




77 


PERIOD PICTURE 99 VALUE 0. 




t> 


==CHG> 




77 


PL-TOTAL-PRICE-NUMERIC-INT PICTURE S9(8)V99 VALUE 0. 




==CHG> 




77 


PL-TOTAL-BMR-NUMERIC-INT PICTURE S9(8)V99 VALUE 0. 






005100 




77 


PL-MAINT-REQ-NUM PICTURE S9(4)V99 VALUE 0. 






005300 




77 


HEADING-SW PICTURE 9 VALUE 1. 






005400 




77 


PREV-DEVICE PICTURE X(6) VALUE SPACES. 






005500 




77 


PREV-RPQ-FEATURE PICTURE XUO) VALUE SPACES. 






005600 




77 


TEMP-MAINT PICTURE S9(7)V99 VALUE 0. 






005700 




77 


TOTAL-BMR PICTURE S9(8)V99 VALUE 0. 






005800 




77 


TOTL-PR PICTURE S9(8)V99 VALUE 0. 






005900 




77- 


TOTAL-MAINT PICTURE S9(7)V99 VALUE 0. 





Figure 31. Edit - CHANGE ALL Command Example 
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Detailed Command Description 






The complete formats for FIND and CHANGE, showing all optional 
parameters, are as follows: 



FIND string-1 C NEXT /ALL/FIRST/LAST/PREV3 
E CHARS /PREFIX/SUFFIX/W0RD3 
CX/NX] 
Ccol-1 Ccol-233 



Command abbreviation: F 

Keyword abbreviations: PRE (for PREFIX), SUF (for SUFFIX) 



CHANGE string-1 string-2 



[ NEXT /ALL/FIRST/LAST/PREV3 

C CHARS /PREFIX/SUFFIX/U1QRD3 

CX/NX3 

Ccol-1 Ccol-233 



Command abbreviations: 
Keyword abbreviations: 



CHG, C 

PRE (for PREFIX), 



SUF (for SUFFIX) 



Note that FIND under edit has the same format 
browse, except for the optional X/NX parameter. 



as FIND under 



J 



The operands may be separated with blanks or commas, and may be 
typed in any order except that string-2 (for CHANGE) must follow 
string-1, and col-2 (if typed) must follow col-1. The string-1 
operand is required (and string-2 for CHANGE); the others are 
opti onal . 

The "string-1" operand specifies the string to be found. It may 
be specified in any one of the following forms: 

• Any string of characters not starting or ending with an apos- 
trophe or quotation mark, and not containing any imbedded 
blanks or commas. 

• A delimited string: Any string starting and ending with an 
apostrophe ( f ) but not containing imbedded apostrophes, or 
starting and ending with a quotation mark (") but not contain- 
ing imbedded quotation marks. 

• A hex string: Any delimited string of valid hexadecimal chai — 
acters, preceded or followed with the character X. Example: 
X'C27B' 

• A text string: Any delimited string of characters, preceded 
or followed with the character T. See discussion under "Use 
of Text Strings." Example: T'conditions for' 

• A picture string: Any delimited string of picture charac- 
ters, preceded or followed with the character P. See dis- 
cussion under "Use of Picture Strings." Example: P f .' 

• A single asterisk (*). This causes the previous value that 
was used as string-1 in either a FIND or CHANGE command to be 
used agai n. 

The "string-2" operand is required for the CHANGE command to spec- 
ify the new value of the string. The rules for coding string-2 
are the same as for string-1, except as follows: 

1. A text or picture string may not be specified for string-2. 

2. If a single asterisk is typed, the previous value of string-2 
that was used in a CHANGE command is used again. 
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The previous value of a character string (referenced via x or used 
by the Find/Change PF keys) is retained until the edit option is 
terminated (i.e., until return to the primary option menu). 



Starting Point and Direction of Search 

The starting point, direction and extent of the search may be 
controlled by one of the following operands. 

NEXT Scan starts at the current cursor location and proceeds 
forwards to find the next occurrence of string-1. 

ALL Scan starts at the top of data and proceeds forwards to 
find all occurrences of string-1. 

FIRST Scan starts at the top of data and proceeds forwards to 
find the first occurrence of string-1. 

LAST Scan starts at the bottom of data and proceeds backwards to 
find the last occurrence of string-1. 

PREV Scan starts at the current cursor location and proceeds 
backwards to find the previous occurrence of string-1. 

If this operand is omitted, the default is NEXT. 

If the direction of the search is forward ( i . e, if FIRST, ALL, or 
NEXT was specified), pressing the Find or Change PF key finds or 
changes the next occurrence of the designated string. If the 
direction of the search is backward (if LAST or PREV was speci- 
fied), pressing these PF keys finds or changes the previous occui — 
rence of the string. The other optional parameters (CHARS, WORD, 
PREFIX, SUFFIX, X, NX, and col-1, col-2) remain in effect, as 
specified in the last FIND or CHANGE command. 

The search proceeds until one or all occurrences of string-1 are 
found, or until the end of data is encountered. If string-1 is 
not found, one of the following actions takes place. 

• For FIRST, LAST, or ALL - a "NO xxxxx FOUND" message is dis- 
played in the upper right-hand corner of the screen. 

• For NEXT - a "BOTTOM OF DATA REACHED" message is displayed. 

• For PREV - a "TOP OF DATA REACHED" message is displayed. 

When "BOTTOM OF DATA REACHED" or "TOP OF DATA REACHED" is dis- 
played, the user may press the Find PF key (for either FIND or 
CHANGE) or the Change PF key (for CHANGE) to continue searching by 
wrapping to the top (or bottom) of the data. If no occurrence is 
found anywhere in the data, a "NO xxxxx FOUND" message is dis- 
played. 



Conditions for Character String Match 

The conditions for a successful "match" with string-1 may be 
controlled based on whether the data string begins and/or ends 
with a non-alphameric character (i.e., a special character or 
blank). The operands are: CHARS, PREFIX (may be abbreviated 
PRE), SUFFIX (may be abbreviated SUF) , and WORD. In the f ollowi ng 
illustration, the underscored strings would be found, and the 
non-underscored strings would be ignored (skipped over). 



{ 
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CHARS 'DO* 


- DO 


DONT 


ADO 


ADOPT 


•DO' 


+ADO 


(DONT) 


ADO- 


PREFIX 'DO' 


- DO 


DONT 


ADO 


ADOPT 


•DO' 


+ADO 


(DONT) 


ADO- 


SUFFIX 'DO' 


- DO 


DONT 


ADjQ 


ADOPT 


•DO' 


+ADQ 


(DONT) 


ADO- 


WORD 'DO' 


- DO 


DONT 


ADO 


ADOPT 


'DO* 


+ADO 


(DONT) 


ADO- 



If this operand is omitted, the default is CHARS. 



Range and Column Limitations 



Under edit, the lines to be searched may be limited by first using 
the "X" or "XX" line commands (see "Excluded Lines"), and then 
specifying one of the following operands on the FIND or CHANGE 
command: 

X - Scan only lines which are excluded from display. 

NX - Scan only lines which are not excluded from display. 

If this operand is omitted, both excluded and non-excluded lines 
will be searched. When an excluded line is searched and string-1 
is found, the line is automatically redisplayed (i.e., it is 
"popped" out from the block of excluded lines). 



Note : The X/NX Operand is not defined 
browse. 



when using FIND under 



>, 



If the "col-1" and "col-2" operands are typed (two integers sepa- 
rated by a comma or at least one blank), they indicate the start- 
ing and ending column positions for the search. If col-1 is 
specified without col-2, the string will be found only if it 
starts in the specified column. If neither col-1 nor col-2 is 
specified, the search will continue across all columns within the 
current boundary columns. See description of BOUNDS commands. 



Use of Text Strings 



) 



A text string, which may be used as string-1 in a FIND or CHANGE 
command, allows the search to be satisfied without regard to 
upper/lower case alphabetics. Example: FIND T'CONDITION NO. 1' 
would successfully find any of the following: 

CONDITION NO. 1 

Condition No. 1 

condition no. 1 

coNDitlON nO. 1 



An ordinary delimited string, such a*: FIND 'CONDITION 
would find only the first example listed above. 



NO. 



Within the text string itself, is is immaterial whether alphabet- 
ics are typed in upper or lower case (even if CAPS mode is off) 
For example, all the following have the same effect: 

FIND T'Edit Commands' 
FIND T'EDIT COMMANDS' 
FIND T'edit commands' 
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Use of Picture Strings 



A picture string* which may be used as string-1 in a FIND or 
CHANGE command, allows the search to be satisfied when a partic- 
ular type of character is encountered. Special characters are 
used within the picture string to represent the type of character 
to be found* as follows: 

STRING MEANING 

P ,= " - any character (don't care) 

p»_t _ an y non-blank character 

P'." - any non-di splayable (invalid) character 

P"** - any numeric character (0-9) 

P»- ? - any non-numeric character 

P T 3 f - any alphabetic character (upper or lowercase) 

P*< f - any lowercase alphabetic character 

P'^ - any uppercase alphabetic character 

P»$» - any special character (not alpha or numeric) 

Any special characters other than the ones listed above are inval- 
id within a picture string. A picture string may also include any 
alphabetic or numeric characters* in which case the characters 
represent themselves. 

Examples of picture strings: 

P f ### f - a string of three numeric characters 

P 1 - - f - any two non-blank characters surrounding a blank 

P ? . f - any non-di splayable character 

P* #* - a blank followed by a numeric character 

P»#AB' - a numeric character followed by 'AB' 

Examples of FIND and CHANGE commands using picture strings: 

FIND P".» - find next non-di splayable character 

FIND P f -» 72 - find next non-blank character 

i n column 72 
C ALL P»=» ' * 73 80 - change any characters in columns 

73-80 to blanks 
F P' -' 1 - find the next line with a blank in 

column 1 followed by a non-blank 

When the picture string P f . f is used to find or change a 
non-di splayable character, the hexadecimal representation of the 
character is shown in the confirmation message which appears in 
the upper right-hand corner of the screen. 
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ADVANCED FEATURES 



The following commands are described in this section 
Line commands: 



MASK 


X (exclude) 


< (data left) 


S (show) 


> (data right) 


F (first) 


( (columns left) 


L (last) 


) (columns right) 


TABS 


BOUNDS 





Primary commands 

COPY 
MOVE 
CREATE 
REPLACE 



NULLS 
TABS 
PROFILE 
HEX 



Mask Definition 



The mask is used in conjunction with the "I" (insert), "TE" (text 
entry), and "TS" (text split) line commands. Whenever a new line 
is inserted, it is pre-filled with the contents of the mask. Ini- 
tially, the mask contains all blanks. 

To display the mask, the characters "MASK" are entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, the mask is displayed at the designated position. 



MASK - Display mask definition line 



Once displayed, the mask may be changed to allow pre-entry of data 
on inserted lines. An example is shown in Figure 32. In this 
example, the mask has been displayed and the characters "/*" and 
"*/" have been entered at the desired positions on the mask line. 
Five new lines are then inserted following line 1700. The second 
part of the example shows that the new lines contain the contents 
of the mask. 

The mask line may be removed from display by entering a "D" in the 
line command area, or by entering a RESET primary command. The 
mask line is never saved as part of the data. 

The mask remains in effect (even if it is not displayed) until it 
is again changed by the user. The contents of the mask are 
retained in the current edit profile, and automatically used the 
next time the user edits the same type of data. 
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EDIT SPFDEM0.SAMPLE.PLHEDI21PM) - 01.01 

COMMAND INPUT ===> 

001100 ELSE 

001200 /* 

001300 DO; 

=COLS> — — + 1 -+—-2 + 3 + — 



COLUMNS 001 072 
SCROLL ===> HALF 



COMPUTE PARM LENGTHS 



*/ 



=MASK> 




/* 


001400 




LP = 8; 


001500 




DO WHILE (EDEMPROJCLP) = ' ' ); 


001600 




LP = LP-li 


15 




END; 


001800 




DO K=l TO 4; 


001900 




IF ED[MLIB(K,1) -= ' ' THEN 


002000 




DO; 


002100 




LL(K) = 8; 


002200 




DO WHILE 


002300 




(EDtMLIB(K,LL(K)) = 


002400 




LL(K) = LL(K)-1; 


002500 




END; 


002600 




END; 


002700 




ELSE 


002800 




LL(K) = 0; 


002900 




END; 


003000 




END; 


003100 


RETURN CODE(O); 


003200 


END 


EDC21PM; 



*/ 



'); 



****** *************************** BOTTOM OF DATA ***************************** 





EDIT — 

COMMAND 






■* OrrUr 
INPUT 


===> SCROLL ===> HALF 




001100 




ELSE 




001200 


/* 


COMPUTE PARM LENGTHS */ 




001300 




DO; 




=COLS> 


+_. 


1 + 2 + 3 + 4 + 5 + 6 + 7 — 




=MASK> 




/* */ 




001400 




LP = 8; 




001500 




DO WHILE (EDIMPROJ(LP) = • '); 




001600 




LP = LP-1; 


> 


001700 




END ; 

/* */ 
/* */ 
/* */ 


> 


001800 




/* */ 
/* */ 
DO K=l TO 4; 




001900 




IF ED(MLIB(K,1) -= ' ' THEN 




002000 




DO; 




002100 




LL(K) = 8; 




002200 




DO WHILE 




002300 




(ED[MLIB(K,LL(K)) = ■ '); 




002400 




LL(K) = LL(K)-1; 




002500 




END; 




002600 




END; 




002700 




ELSE 




002800 




LL(K) = 0; 




002900 




END; 



Figure 32. Edit - Define Mask Example 



70 SPF-VM Program Reference 



Indentation Changes 



The contents of a line (or block of lines) may be shifted left or 
right by means of the shift line commands. The two forms of these 
commands arei 



">" and "<" 

")" and "(" 



for "data" shifting 
for "column" shifting 



Data shifting attempts to shift the body of a program statement 
without shifting the label or comments, and will prevent loss of 
data. Column shifting shifts information without regard to its 
contents, and may result in the loss of data. (See further dis- 
cussi on below. ) 

To shift the contents of a line left, the single character "<" or 
"(" is entered in the line command area, overtyping the line num- 
ber. When the ENTER key is pressed, the data in the line contain- 
ing the command is shifted left by two column positions (two is 
the default for shift operations). 



< 


- Data 


shift 


line left 2 positions 


<n 


- Data 


shift 


line left "n" positions 


<< 


- Data 


shift 


block of lines left 2 positions 


<<n 


- Data 


shift 


block of lines left "n" positions 



( 


- 


Col. 


shift 


line left 2 positions 


(n 


- 


Col. 


shift 


line left "n" positions 


(( 


- 


Col. 


shift 


block of lines left 2 positions 


C(n 


— 


Col. 


shift 


block of lines left "n" positions 



To shift a block of lines left, "<<" or "((" is entered in the 
line command area of the first and last lines to be shifted. The 
first and last lines need not be on the same page; scrolling may 
be used between entering the first command and the second command. 

The equivalent commands for right shifting are ">", ")", ">>" and 
" ) ) " . 



| 



> 


- Data 


shift 


line right 2 positions 


>n 


- Data 


shift 


line right "n" positions 


>> 


- Data 


shift 


block of lines right 2 positions 


>>n 


- Data 


shift 


block of lines right "n" positions 



) 


- Col. 


shift 


line right 2 positions 


)n 


- Col. 


shift 


line right "n" positions 


)) 


- Col. 


shi ft 


block of lines right 2 positions 


))n 


- Col. 


shift 


block of lines right "n" positions 



A number may be entered following any of the shift commands to 
indicate the number of column positions to be shifted. For exam- 
ple, ">>5" entered on the first or last (or both) lines to be 
shifted would cause a right shift of five column positions. 

Shifting occurs within column boundaries that may be changed by 
the user. Default column boundaries are established by edit, 
based on the data set "type" (lowest level qualifier of the data 
set name). The default boundaries are normally the first and last 
columns where source text may be entered for the particular pro- 
gramming language. See BOUNDS command for a discussion of default 
boundaries and the procedures for changing them. 
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Data Shifting - ">" and w <» 

Within the column boundaries* data shifting is accomplished by 
squeezing out multiple blank characters at one end of the data, 
and increasing the number of blanks at the other end. The follow- 
ing rules are followed in performing a data shift. 

• Non-blank characters are never deleted or truncated. 

• A single blank is never deleted. 

• Within apostrophes, the number of multiple blanks is never 
changed. 

• Non-blank characters are never shifted into or out of the left 
column boundary position (normally the label field). 

• If a shift cannot be completed, it is partially performed and 
the line number is replaced with the following intensified 
warning message: ==ERR>. The warning message may be removed 
via the RESET primary command, or by overtyping the message or 
data on that line. 

Figure 33 shows a before-and-af ter example of data shifting. The 
block of lines, starting at line 1910 through line 1980, is 
shifted left four column positions. 



Column Shifting - ")" and »(" 

Column shifting is accomplished by simply moving all of the 
characters (within the column boundaries) left or right by the 
designated number of positions. There is no squeezing or increas- 
ing of blanks. There is no restriction on shifting non-blank 
characters into or out of a column boundary position. Characters 
shifted beyond a column boundary postion &re lost, with no warning 
message. 
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EDIT — 

COMMAND 

001800 

001900 

«4 

001920 

001930 

001940 

001950 

001960 

001970 

« 

002000 

002100 

002200 



SPFDEMO.MYLIB.PLK TESTDIR) - 01.03 
INPUT ===> 
END! 
ELSE 

DO; 
PUT 



COLUMNS 001 072 
SCROLL ===> HALF 



PUT 



FILE(SYSPRINT) 

EDITCTEST NOTES ERROR RETURN FROM D-I-R') 

(C0LUMN(21),A(34)); 
FILE(SYSPRINT) SKIP(2) 
DATA( ERROR-FLAG, CARD-IMAGE, ANSWER); 



ERROR- 
END; 



FLAG = 'O'B; 



END; 
END TESTDIR; 



****** *************************** BOTTOM OF DATA ***************************** 



t> ? 



D> 



EDIT — 


- SPFDEMQ.MYL 


COMMAND 


INPUT 


===> 


001800 




END; 


001900 


ELSE 


001910 




DO; 


001920 




PUT 


001930 






001940 






001950 




PUT 


001960 






001970 




ERRO 


001980 




END; 


002000 




; 


002100 


END 




002200 


END TESTDIR; 



COLUMNS 001 072 
SCROLL ===> HALF 



FILE(SYSPRINT) 

EDITCTEST NOTES ERROR RETURN FROM D-I-R') 

(COLUMN(21),A(34)); 
FILE(SYSPRINT) SKIP(2) 
DATA( ERROR-FLAG, CARD-IMAGE, ANSWER); 
R-FLAG = "O'B; 



****** *************************** BOTTOM OF DATA ***************************** 



Figure 33. Edit - Left Shift Data Example 
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Boundary Column Definition 

To display the column boundary definition line* the characters 
"BOUNDS" (or an acceptable abbreviation) are entered in the line 
command area, overtyping the line number. When the ENTER key is 
pressed, the boundary definition line is inserted at the desig- 
nated position. 



BOUNDS - Display boundary definition line 



Command abbreviations: BOUND, BNDS, BND 



The column boundaries are used to limit the scope of: 

• Left and right shift line commands 

• FIND and CHANGE commands when explicit columns were not spec- 
ified by the user 

• Text entry, text split, and text flow line commands 

• Overlay line command 

• Left and right scrolling. 

The effect on left and right scrolling is as follows: 

1. A left scroll will stop at the left bound, and a right scroll 
will stop at the right bound. A subsequent left or right 
scroll will go beyond the bound (assuming the bound is not at 
the left-most or right-most column position). 

2. The initial display (when edit is entered) will be 
pre-scrolled so that the left boundary column is the first 
column displayed. 

The boundaries are initialized by edit based on the data set 
"type" (the- lowest level qualifier in the data set name) and 
whether or not the data is sequence numbered. The default left 
and right column boundaries ar& shown in Figure 34. 



RECORD 
FORMAT 


DATA 
TYPE 


NUMBERED 


UNNUMBERED 


FIXED 
LENGTH 








ASM or 
ASSEMBLE 


1, 71 


1, 71 


COBOL 


7, 72 


7, 72 


(OTHER) 


1, LRECL-8 


1, LRECL 


VARIABLE 
LENSTH 


(ANY) 


9, LRECL 


1, LRECL 



Figure 34. Edit - Default Column Boundary Settings 
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The user may change the boundaries by displaying the boundary 
definition line and changing its contents. The boundary defi- 
nition line contains a single "<" character indicating the posi- 
tion of the left column boundary, and a single ">" character 
indicating the position of the right column boundary. If the user 
has already changed the boundaries, he may revert to the default 
bounds by displaying the boundary definition line and blanking 
out its contents. The ERASE EOF key may be used for this purpose. 

If the default boundaries are in effect, they are automatically 
adjusted whenever NUMBER mode is turned on or off. If the user 
has changed the bounds from the default settings, they are not 
affected by the setting of NUMBER mode. 

Figure 35 shows an example of the boundary definition line 
displayed together with the column identification line. In this 
example, the left bound is currently set at column 42 and the 
right bound at column 70. 

The boundary definition line may be removed from display by enter- 
ing a "D" in the line command area, or by entering a RESET primary 
command. The boundary definition line is never saved as part of 
the data. 

The boundary definition line is retained in the current edit pro- 
file, and automatically used the next time the user edits the same 
type of data. 






> 



EDIT — 

COMMAND 

001400 

001500 

001600 

=COLS> - 

=BNDS> 

001700 

001800 

001900 

002000 

002100 

002200 

002300 

002400 

002500 

002600 

002700 

002800 

002900 



01.00 



SPFDEMO. SAMPLE. PLHBROPDS) 
INPUT ===> 

IF BR0SMEMBC1) -= • ' THEN 
DO; 

^INCLUDE SYSLIB(BROFINDM); 
+ J -+——2 +. 3 +— 

IF BRORCODE = THEN 
DO; 

XINCLUDE SYSLIB(BROPDSH);/* 
CALL CBRO (TLD,TDC); 
END; 
ELSE 

BROMLIST = OFF; 
END; 

ELSE /* 

BROMLIST = OFF; /* 

END; /* 

BROSMEMB = BLANKS; /* 

END ; /* 





SCROLL ===> HALF 


/* 


IF MEMBER SELECTED, */ 


/* 


*/ 


/* 


FIND MEMBER */ 


< 


> 


/* 


IF NO ERRORS, */ 


/* 


*/ 


H);/* 


SET UP PDS HEADER */ 


/* 


CALL COMMON BROWSE */ 


/* 


*/ 


/* 


ELSE, */ 


/* 


TURN OFF LIST FLAG */ 


/* 


*/ 



****** *************************** BOTTOM OF DATA 



ELSE (NOTHING SELECTED),*/ 

TURN OFF LIST FLAG */ 

END OF LOOP */ 

CLEAR SELECTED MEMBER */ 

*/ 
***************************** 



Figure 35. Edit - Boundary Definition Line 
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Excluded Lines 



When editing a program segment which exceeds the screen data size, 
it is often difficult to determine whether the control structure 
and indentation levels are correct. The excluded lines capabili- 
ty allows blocks of lines to be collapsed so that the overall con- 
trol structure may be viewed. The lines are excluded from display 
but are not deleted in the data. 

Excluded lines may also be used in conjunction with the "X Tf and 
"NX" options of the FIND and CHANGE commands to limit the scope of 
search, and/or to easily identify lines which have been found or 
changed by causing them to "pop out" of a block of excluded lines. 

To exclude a line, the single character "X" is entered in the line 
command area, overtyping the line number. A number may follow the 
"X" to indicate that more than one line is to be excluded. For 
example, "X5" would cause five lines to be excluded, starting with 
the line containing the "X5". When the ENTER key is pressed, the 
line(s) are replaced with a single message line, which indicates 
how many lines were excluded. 



X - Exclude line 

Xn - Exclude "n" lines 

XX - Exclude block of lines 



To exclude a block of lines, the double character "XX" is entered 
in the line command area of the first and last lines to be 
excluded. The first and last lines need not be on the same page. 

Figure 36 shows a before-and-after example of excluded lines. 
The block of lines, starting at line 1600 through line 2600, is 
excluded from display and replaced with a single message line. 

Excluded lines may be redisplayed by entering the RESET primary 
command. Alternatively, one or more excluded lines may be redis- 
played by entering "S" (show), "F" (first), or "L" (last) in the 
line command area of the "EXCLUDED LINES" message, overtyping the 
dashes which are normally in that area. Each of these line com- 
mands may be followed by a number to cause redisplay of more than 
one line. 



s 

Sn 


- 


Show 
Show 


li ne 

"n" lines 




F 
Fn 


- 


Show 
Show 


f i rst line 

f i rst "n" lines 




L 
Ln 


- 


Show 
Show 


last line 
last "n" lines 
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EDIT — 
COMMAND 


- <5PPnPMfi «?AMDI F PIT(RDnpn<31 - 01 ftJ> 








OrrUCI l\J • OAilrLC • rLil DKUrUQ 1 — U1«UC *■ 

INPUT ===> 




SCROLL ===> HALF 




000700 


^INCLUDE SYSLIB(BROLISTM); 


/* 


LIST MEMBER NAMES 


*/ 




000800 


END; 


/* 




*/ 




000900 


ELSE 


/* 


ELSE, 


*/ 




001000 


DO; 


/* 




*/ 




001100 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ 




001200 


BROSMEMB = BROMMEMB; 


/* 


MOVE MEMBER NAME TO 


*/ 




001300 


END; 


/* 


•SELECTED* MEMBER 


*/ 




001400 


IF BROSMEMB(l) -= ' ' THEN 


/* 


IF MEMBER SELECTED, 


*/ 


> 


001500 


DO; 


/* 




*/ 


XX 


^INCLUDE SYSLIB(BROFINDM); 


/* 


FIND MEMBER 


*/ 


001700 


IF BRORCODE = THEN 


/* 


IF NO ERRORS, 


*/ 




001800 


DO; 


/* 




*/ 




001900 


^INCLUDE SYSLIB(BROPDSH) 


;/* 


SET UP PDS HEADER 


*/ 




002000 


CALL CBRO (TLD,TDC); 


/* 


CALL COMMON BROWSE 


*/ 




002100 


END; 


/* 




*/ 




002200 


ELSE 


/* 


ELSE, 


*/ 




002300 


DO; 


/* 




*/ 




002400 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ , 


> 


002S00 


BROSMEMB = BLANKS; 


/* 


CLEAR SEL. MEMBER 


*/ 


XX 


END; 


/* 




*/ 


002700 


END; 


/* 




*/ 




002800 


ELSE 


/* 


ELSE (NOTHING SELECTED) 


,*/ 




002900 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ 




003000 


END; 


/* 


END OF LOOP 


*/ 




003100 


BROSMEMB = BLANKS; 


/* 


CLEAR SELECTED MEMBER 


*/ 




003200 


END; 


/* 




*/ 



Jf 







EDIT ~ 
COMMAND 


- SPFDEMO. SAMPLE. PLKBROPDS) - 01. 
INPUT ===> 


02 








SCROLL ===> HALF 


000700 


XINCLUDE SYSLIB(BROLISTM); 


/* 


LIST MEMBER NAMES */ 


000800 


END; 




/* 


*/ 


000900 


ELSE 




/* 


ELSE, */ 


001000 


DO; 




/* 


*/ 


001100 


BROMLIST = OFF; 




/* 


TURN OFF LIST FLAG */ 


001200 


BROSMEMB = BRCMMEMB; 




/* 


MOVE MEMBER NAME TO */ 


001300 


END; 




/* 


•SELECTED* MEMBER */ 


001400 


IF BROSMEMB(l) -a • ' THEN 




/* 


IF MEMBER SELECTED, */ 


001500 


DO; 




/* 


*/ 


002700 


END; 




/* 


*/ 


002800 


ELSE 




/* 


ELSE (NOTHING SELECTED),*/ 


002900 


BROMLIST = OFF; 




/* 


TURN OFF LIST FLAG */ 


003000 


END; 




/* 


END OF LOOP */ 


003100 


BROSMEMB = BLANKS; 




/* 


CLEAR SELECTED MEMBER */ 


003200 


END; 




/* 


*/ 


****** *************************** BOTTOM 


OF 


DATA 


***************************** 






Figure 36. Edit - Excluded Lines Example 
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The "S" line command causes the block of excluded lines to be 
scanned, and one or more lines selected for redisplay. The 
selected lines are those with the left-most indentation levels 
(i.e, with the fewest number of leading blanks). If "S3" is 
entered, for example, the three lines with the left-most indenta- 
tion level will be redisplayed. If more than three lines exist at 
this indentation level, the first three will be displayed. 

The "F" line command causes one or more lines at the beginning of 
the block to be redisplayed. The "L" line command causes one or 
more lines at the end of the block to be redisplayed. 

Figure 37 shows a before-and-after example of redisplaying 
excluded lines. The command "S3" is entered in the line command 
area of the "EXCLUDED LINES" message. Three lines with the high- 
est indentation level are redisplayed. 

Any line command that normally operates on a single line may be 
entered in the line command area of the "EXCLUDED LINES" message. 
For example, a "D" entered on that line will delete the entire 
block of excluded lines. This feature is particularly useful in 
conjunction with the shift commands. Suppose, for example, you 
want to "data" shift all lines to the left by 4 column positions. 
Proceed as follows: 

1. On the first data line, enter "X99999". This will exclude all 
lines. 

2. On the "EXCLUDED LINES" message* enter the shift command 
"<4". 

3. In the primary command area, enter the RESET command to bring 
the lines back into view. 

Note : Excluded lines need not be redisplayed before saving the 
data. The "EXCLUDED LINES" message line is never saved as part of 
the data. 
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> 



EDIT — 
COMMAND 


- SPFDEMO. SAMPLE. PLKBROPDS) - 01. 
INPUT ===> 


nj> . 










SCROLL ===> HALF 


000700 


^INCLUDE SYSLIB(BROLISTM); 


/* 


LIST MEMBER NAMES */ 


000800 


END; 




/* 


*/ 


000900 


ELSE 




/* 


ELSE, */ 


001000 


DO; 




/* 


*/ 


001100 


BROMLIST = OFF; 




/* 


TURN OFF LIST FLAG */ 


001200 


BROSMEMB = BROMMEMB; 




/* 


MOVE MEMBER NAME TO */ 


001300 


END; 




/* 


•SELECTED' MEMBER */ 


001400 


IF BROSMEMB(l) -s ' ' THEN 




/* 


IF MEMBER SELECTED, */ 


001500 


DO; 




/* 


*/ 


002700 


END; 




/* 


*/ 


002800 


ELSE 




/* 


ELSE (NOTHING SELECTED),*/ 


002900 


BROMLIST = OFF; 




/* 


TURN OFF LIST FLAG */ 


003000 


END; 




/* 


END OF LOOP */ 


003100 


BROSMEMB = BLANKS; 




/* 


CLEAR SELECTED MEMBER */ 


003200 


END; 




/* 


*/ 


****** i 


*************************** BOTTOM 


OF 


DATA 


***************************** 





EDIT — 

COMMAND 


- SPFDEMO. SAMPLE. PLKBROPDS) - 01. 
INPUT ===> 


nj> 




____ __«-. rniiiMMQ rtfti 


072 
HALF 








SCROLL ===> 




000700 


XINCLUDE SYSLIB(BROLISTM); 


/* 


LIST MEMBER NAMES 


*/ 




000800 


END; 




/* 




*/ 




000900 


ELSE 




/* 


ELSE, 


*/ 




001000 


DO; 




/* 




*/ 




001100 


BROMLIST = OFF; 




/* 


TURN OFF LIST FLAG 


*/ 




001200 


BROSMEMB = BROMMEMB; 




/* 


MOVE MEMBER NAME TO 


*/ 




001300 


END; 




/* 


'SELECTED' MEMBER 


*/ 




001400 


IF BROSMEMB(l) -= ' • THEN 




/* 


IF MEMBER SELECTED, 


*/ 


> 


001500 


DO; 




/* 




*/ 


001600 


^INCLUDE SYSLIBC BROFINDM ) ; 




/* FIND MEMBER 


*/ 


001700 


IF BRORCODE = THEN 




/* 


IF NO ERRORS, 


*/ 












— A. 1 TMPC <S1 KHVT nT<SDI Avcn 


t> 


002200 


ELSE 




/* 


ELSE, 


*/ 










_ A. 1 TKIPfC) klftT nT^Dl AVEn 


002700 


END; 




/* 




*/ 




002800 


ELSE 




/* 


ELSE (NOTHING SELECTED),*/ 




002900 


BROMLIST = OFF; 




/* 


TURN OFF LIST FLAG 


*/ 




003000 


END; 




/* 


END OF LOOP 


*/ 




003100 


BROSMEMB = BLANKS; 




/* 


CLEAR SELECTED MEMBER 


*/ 




003200 


END; 




/* 




*/ 




****** 


*************************** BOTTOM 


OF 


DATA 


***************************** 



Figure 37. Edit - Show Lines Example 
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Data Merging and Segmentation 

Merging or segmentation of data is accomplished by moving or copy- 
ing lines into or out of the data being edited. To merge data, a 
primary command is used to specify the source of the move or copy, 
and a line command is used to specify the destination. To segment 
data, the process is reversed. 



Merging Data 

The COPY and MOVE primary commands (not be confused with the line 
commands of the same name) &r& used to specify a member of a pai — 
titioned data set or a sequential data set to be copied into the 
data being edited. If the MOVE command is used, the member or 
sequential data set is deleted following a successful read opei — 
ation. (For a concatenated sequence of SPF libraries, the delete 
occurs only if the member was in the first library of the 
concatentati on sequence.) These commands are of the form: 



COPY Cmembei — name] 



MOVE Cmembei — name] 



If the "membei — name" operand is entered, the member is fetched 
from the data set (or concatenated sequence of data sets) current- 
ly being edited. If the operand is omitted, a menu will be dis- 
played to allow specification of any partitioned data set member 
or sequential data set as the source for the COPY or MOVE. 

The destination for the COPY or MOVE is specified by the "A" (af- 
ter) or "B" (before) line command in the data being edited. The 
"A" or "B" line command need not be entered if the data being 
edited contains no lines (new member or empty sequential data 
set). Note that a number may not follow the "A" or "B" line 
command when it is used in conjunction with a COPY or MOVE primary 
command. 

If the membei — name operand is omitted on the COPY or MOVE primary 
command, the "A" or "B" line command must be entered before the 
data set menu will be displayed (unless the data being edited con- 
tains no li nes) . 

The COPY menu allows a range of lines in the source data set to be 
specified. The line searching criteria must also be specified, as 
follows: 

• STANDARD - search for 8-character "standard" line numbers 

• COBOL - search for 6-character COBOL line numbers 

• RELATIVE - ignore line numbers in the data, and interpret the 
specified line numbers as relative to the start of the data. 

See "Sequence Number Generation and Control" for a further dis- 
cussion of standard and COBOL line numbers. 

Figure 38 shows an example of the COPY command. Member CBLC0DE1 
is being edited in data set SPFDEMO.XXX. COBOL . A COPY command 
with no operand is entered in the primary command area, and an "A" 
line command is entered at line 500. When the ENTER key is 
pressed, the COPY menu is displayed (second half of the figure). 
In this example, lines 1000 through 2300 of member ENVD in data 
set MASTER. OLD. COBOL are to be copied. When the menu has been 
filled in and the ENTER key pressed, the lines will be copied and 
inserted after line 500, and the edit data will be redisplayed. 
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> 



> 



EDIT — SPFDEMO.XXX.COBOL(CBLCODEl) - 01.01 - 
COMMAND INPUT ===> COPY 

****** *************************** TOP OF DATA 
IDENTIFICATION DIVISION. 

PROGRAM-ID. SMPLCBL - SAMPLE CBL PROGRAM. 
AUTHOR. JOE BLOW. 



COLUMNS 007 078 

SCROLL ===> HALF 
******************************** 



000100 

000200 

000300 

000400 

A _ 

000600 

000700 

000800 

000900 

001000 

001100 

001200 

001300 

001400 

001500 

001600 

001700 

001800 

001900 

002000 

002100 

002200 

002300 

002400 



ENVIRONMENT DIVISION. 

DATA DIVISION. 

FILE SECTION. 

FD SYSPRINT 

LABEL RECORD IS OMITTED 
DATA RECORD IS PRINT- LINE. 
01 PRINT-LINE. 

02 LINE-FIELD PICTURE X(121). 
WORKING-STORAGE SECTION. 
01 PRINT-VALUE PICTURE X(121) 

VALUE • PRINT LINE PRODUCED BY SAMPL 
'E CBL PROGRAM.'. 

PROCEDURE DIVISION. 
BEGIN. 

OPEN OUTPUT SYSPRINT. 

WRITE PRINT-LINE FROM PRINT-VALUE. 

CLOSE SYSPRINT. 

STOP RUN. 



****** *************************** BOTTOM OF DATA ***************************** 



) 



EDIT - COPY MENU 

"CURRENT" FILE: SPFDEMO.XXX.COBOL(CBLCODEl ) 



SPF LIBRARY: 

PROJECT ===> MASTER 
LIBRARY ===> OLD 
TYPE ===> COBOL 
MEMBER ===> ENVD 



CMS FILE: 

FILE ID ===> 

MEMBER ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> 

READ PASSWORD ===> 



DEVICE ADDR. ===> 

(IF PASSWORD PROTECTED) 



LINK ACCESS MODE ===> 



) 



LINE NUMBERS (BLANK FOR ENTIRE MEMBER OR SEQUENTIAL FILE): 

FIRST LINE ===> 1000 

LAST LINE ===> 2300 

NUMBER TYPE ===> COBOL (STANDARD, COBOL, OR RELATIVE) 

PRESS ENTER TO COPY OR PRESS END KEY TO CANCEL COPY 



Figure 38. Edit - COPY Command Example 
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Segmenting Data 



The CREATE and REPLACE primary commands are used to specify a 
member of of a partitioned data set or a sequential data set to be 
written from the data being edited. CREATE may be used only to 
specify a member of a partitioned data set. It will add the mem- 
ber providing a member of the same name does not already exist in 
the data set. REPLACE will add or replace a member in a parti- 
tioned data set or rewrite an entire sequential data set. The 
commands are of the form: 



CREATE 


t membei — name] 






Command 


abbrevi ati on: 


CRE 


, 




REPLACE 


[membei — name] 






Command 


abbreviat i oris: 


REPLV 


REP 



If the "membei — name" operand is entered, the member will be writ- 
ten in the data set currently being edited. (For a concatenated 
sequence of SPF libraries, the member is always written in the 
first library of the concatenation sequence.) If the operand is 
omitted, a menu will be displayed to allow specification of any 
partitioned data set member or sequential data set as the destina- 
tion of the operation. 

The source of the operation is specified by the "C" (copy) or "M" 
(move) line commands. The block form — "CC" or "MM" — may be 
used to specify the first and last lines. If the "M" or "MM" line 
command is used, the lines are deleted from the data being edited 
following a successful write operation. The form "Cn" or "Mn", 
where "n" is a large number, may be used on 
copy or move all the data. 



the first data line to 



If the member-name operand is omitted on the CREATE or REPLACE 
primary command, the line command(s) designating the source of 
the operation must be entered before the data set menu will be 
displayed. 

Figure 39 shows an example of the REPLACE command. Member 
CBLC0DE1 is being edited in data set SPFDEMO. XXX. COBOL . Lines 800 
through 1700 sre to be moved, as indicated with the "MM" line com- 
mands. The entire contents of sequential data set TEMP.SAVE are to 
be replaced with lines 800 through 1700. 

Note : The data which is written to the destination data set is 
renumbered if both NUMBER mode and AUTONUM are in effect. A 
source listing of the data is also recorded in the SPF list data 
set for eventual printing, provided PRINT mode is in effect. 
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> 



EDIT — 

COMMAND 

000560 

000570 

000600 

000700 

MM 

000900 

001000 

001100 

001200 

001300 

001400 

001500 

001600 

MM 

00l800 

001900 

002000 

002100 

002200 

002300 

002400 



SPFDEMO.XXX.COBOL(CBLCODEl) - 01.01 — 
INPUT ===> REPLACE 
SELECT SYSPRINT 
ASSIGN TO UT-S-PRINT. 

DATA DIVISION. 

FILE SECTION. 

FD SYSPRINT 

LABEL RECORD IS OMITTED 
DATA RECORD IS PR INT- LINE. 
01 PRINT- LINE. 

02 LINE-FIELD PICTURE XU21). 
WORKING-STORAGE SECTION. 



COLUMNS 007 078 
SCROLL ===> HALF 



01 PRINT- VALUE 



PICTURE X(121) 

VALUE ' PRINT LINE PRODUCED BY SAMPL 
•E CBL PROGRAM.". 



PROCEDURE DIVISION. 
BEGIN. 

OPEN OUTPUT SYSPRINT. 

WRITE PRINT- LINE FROM PRINT-VALUE. 

CLOSE SYSPRINT. 

STOP RUN. 



****** *************************** BOTTOM OF DATA ***************************** 





"CURRENT" FILE: SPFDEMO.XXX.COBOL(CBLCODEl ) 




ENTER/VERIFY PARAMETERS BELOW: 




SPF LIBRARY: 




PROJECT ===> SPFDEMO 




LIBRARY ===> XXX 




TYPE ===> COBOL 




MEMBER ===> 




CMS FILE: 


FOR NEW CMS FILE: 


FILE ID ===> NEWFILE COBOL Al 


RECFM ===> (F OR V) 


MEMBER ===> 


LRECL ===> 


IF NOT LINKED, SPECIFY: 




OWNER'S ID ===> DEVICE ADDR. ===> 


LINK ACCESS MODE ===> 


UPDATE PASSWORD ===> 




PRESS ENTER TO REPLACE 




PRESS END KEY TO CANCEL REPLACE 





} 



Figure 39. Edit - REPLACE Command Example 
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Nulls Control 



The NULLS mode determines whether trailing blanks in each data 
field are written to the screen as blanks or nulls. The term "da- 
ta field" normally refers to the 72 characters of data on each 
line. Using hardware tabs, however, each line can be split into 
multiple fields (see "Tabs Definition and Control"). 

NULLS mode may be turned on or off by using the NULLS command. 
Format: 



NULLS 


CON/OFF] 


CALL] 




Comman 


d abbrevia 


ti on: 


NULL 



The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. 

The ALL operand is valid only when NULLS mode is turned on. If 
ALL is typed, it causes all trailing blanks to be replaced with 
nulls and all-blank fields to be replaced wi th all-nulls. If ALL 
is omitted, one trailing blank is preserved (followed by nulls) 
and all-blank fi elds continue to contain blanks. 

Blank characters (hexadecimal '40') and null characters 
(hexadecimal '00") both display as blanks. The reason for trail- 
ing nulls is to simplify use of the INSERT key on the IBM 3270 
keyboard. This key may be used to insert characters on a line, 
providing the line contains trailing nulls. In addition to using 
the NULLS command, the user may create nulls at the end of a line 
via the ERASE EOF or DELETE key. Null characters are never stored 
in the data; they are always translated back to blanks. 



Tabs Definition and Control 

Three types of tabs are available: "software" tabs, "hardware" 
tabs, and "logical" tabs. 

"Software" tabs are used by edit to reposition the cursor. When- 
ever the cursor is in the data portion of a line and the ENTER key 
is pressed, the cursor is moved to the next software tab position 
(providing software tabs have been defined). 

"Hardware" tabs allow the use of the TAB FORWARD and TAB BACKWARD 
keys to move the cursor to usei — defined column positions within 
the data. This is accomplished by inserting additional attribute 
bytes in each 72-character data area, which splits the data area 
into multiple fields. When the TAB FORWARD or TAB BACKWARD key is 
pressed, the cursor is moved to the screen position immediately 
following the next or previous attribute byte. There are always a 
least two attribute bytes on each edit line; one at the beginning 
of the line number field, and one at the beginning of the data. 

The advantage of hardware tabs is that no program interrupt is 
generated when the TAB FORWARD and TAB BACKWARD keys are pressed. 
The disadvantage is that each attribute byte occupies a screen 
position and may not be overtyped. The attribute bytes display as 
blanks. 

"Logical" tabs are used by edit to break up strings of data 
entered on a line and reposition the strings to usei — defined tab 
positions. The beginning of each string is indicated by a 
user-designated special character. See discussion of TABS prima- 
ry command. 

Note : Tabs are not functional when using the text entry (TE) line 
command. 
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Use of tabs is controlled by two commands: The tabs line command 
which defines tab positions, and the TABS primary command which is 
used to turn TABS mode on and off. 



Tabs Line Command 



The tabs line command is used to define tab positions for all 
three types of tabs. To display the tab definition line, the 
characters "TABS" or "TAB" are entered in the line command area, 
overtyping the line numbers. When the ENTER key is pressed, the 
tab definition line is inserted at the designated position. 



TABS 


- 


Di splay 


tab 


def i ni t 


i on 


1 


i ne 


Comman 


d 


abbreviati on 


: 


TAB 









Software tab positions are defined by typing an underscore (_) or 
hyphen (-) at each desired column position on the tab definition 
line. Two or more consecutive underscores or hyphens may be typed 
to define a software tab field, which causes the cursor to be 
repositioned to the first non-blank character within the field. 
If the tab field contains all blanks, the cursor is positioned at 
the beginning of the field. 

Hardware and logical tab positions are defined by typing an astei — 
i sk (*) at each desired column position on the tab definition 
line. The asterisks indicate the locations where the attribute 
bytes will be inserted (for hardware tabs) or the locations fol- 
lowing which strings will be repositioned (for logical tabs). 

Initially, the tab definition line contains all blanks. If the 

user displays the tab line and enters software tab definitions, 

they take effect immediately; each line contains a software tab or 

I* tab field at the designated column positions. Hardware and log- 

¥ ical tab definitions do not take effect immediately. The astei — 

i sks define the column positions, but the insertion of attribute 
bytes (hardware tabs) or the repositioning of data strings (log- 
ical tabs) does not occur unless TABS mode is ON. The user may 
enter or leave TABS mode via the TABS ON/OFF primary command. 

Figure 40 shows an example of the tab definition line displayed 
together with the column identification line. The tab line shows 
a software tab field extending from columns 2 through 39, and a 
hardware/logical tab definition at column 43. 

The tab definition line may be removed from display by entering a 
"D" in the line command area, or by entering a RESET primary com- 
mand. The tab definition line is never saved as part of the data. 

The tab definitions remain in effect (even if not displayed) until 
they are again changed by the user. Tab definitions are retained 
in the current edit profile, and automatically used the next time 
the user edits the same type of data. 



Edit (Option 2) 85 



D> 



EDIT ~ 
COMMAND 


- <5DPnPMfl <3AMDI P PI Tf RDflDn<i I _ fll W> . 






OrrUCI IU • OAI lr*L.C . r L.XI DKurUv $ *■ UltUt " 

INPUT ===> _ 




SCROLL ===> HALF 


001400 


IF BROSMEMBU) •*= • 'THEN 


/* 


IF MEMBER SELECTED, 


*/ 


001500 


DO; 


/* 




*/ 


001600 


XINCLUDE SYSLIBC BROFINDM ) ; 


/* 


FIND MEMBER 


*/ 


001700 
=COLS> 
=TABS> 
001800 


IF BRORCODE = THEN 


/* 


IF NO ERRORS, 


*/ 










DO; 


/* 




*/ 


001900 


^INCLUDE SYSLIB( BROPDSH ) ?/* 


SET UP PDS HEADER 


*/ 


002000 


CALL CBRO <TLD,TDC)J 


7* 


CALL COMMON BROWSE 


*/ 


002100 


END; 


/* 




*/ 


002200 


ELSE 


/* 


ELSE, 


*/ 


002300 


DO; 


/* 




*/ 


002400 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ 


002500 


BROSMEMB = BLANKS; 


/* 


CLEAR SEL. MEMBER 


*/ 


002600 


END; 


/* 




*/ 


002700 


END; 


/* 




*/ 


002800 


ELSE 


/* 


ELSE (NOTHING SELECTED) 


,*/ 


002900 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ 


003000 


END; 


/* 


END OF LOOP 


*/ 


003100 


BROSMEMB = BUNKS; 


/* 


CLEAR SELECTED MEMBER 


*/ 


003200 


END; 


/* 




*/ 


****** 


*************************** BOTTOM OF 


DATA 


***************** ************ 



Figure 40. Edit - Tab Definition Line 



TABS Primary Command 



TABS mode may be turned on or off by using the TABS primary 
command. Format: 



TABS CON/OFF] [tab-character] CALL] 



Command abbreviation: TAB 



The operands may be typed in any order. If the ON/OFF operand is 
omitted, ON is the default. The "tab-character" and "ALL" oper- 
ands are valid only when TABS mode is turned on. 

The "tab-character" operand consists of a single, non-alphameric 
(special) character. It defines the character to be interpreted 
as a logical tab when encountered on input. Example: 

TABS ON $ 

If the user then enters the following information on a line: 

$aaaaa$bbb$cccc 

the data "aaaaa" will be repositioned after the first tab column 
(as defined by an "*" in the tab def ini tion line), the "bbb" will 
be reposi ti oned after the next tab column, etc., as follows: 



TABS 



aaaaa 



bbb 



cccc 
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If the "tab-character" operand is not typed when TABS mode is 
turned on, hardware tabs are initiated by inserting attribute 
bytes at each tab position defined by an "*" in the tabs defi- 
nition line. If the ALL operand is coded, an attribute byte is 
inserted at all usei — defined positions on each line, overlaying 
any characters in those positions. If the ALL operand is omitted, 
an attribute byte is inserted at each user-defined position on 
each line only if that character position currently contains a 
blank or null . 

Overlaying of characters with attribute bytes applies to the 
screen contents only; the attribute bytes are never recorded in 
the data. When TABS mode is turned off, the attribute bytes are 
removed and the /overlaid character at each tab position is redis- 
played. 

In TABS mode, the user may temporarily cause the attribute bytes 
to be removed on a single line by blanking out the entire line 
command field or by placing the cursor directly under one of the 
attribute bytes and pressing the ENTER key. When the ENTER key is 
pressed again, the attribute bytes will be reinserted. 



Profile Display and Control 

The current edit profile may be displayed at any time by means of 
the PROFILE primary command. This command may also be used to 
define a new profile or switch to a different profile. Format: 



PROFILE [name] [number] 



Command abbreviations: PROF, PRO 



Both operands are optional, and may be coded in either order. The 
"name" operand consists of up to eight alphameric characters, the 
first of which must be alphabetic. The "number" operand consists 
of a single digit in the range to 7, inclusive. 

If neither operand is typed, the contents of the profile are dis- 
played in the data area of the screen (Figure 41). The first 
three lines show the current mode settings. The remaining lines 
show the current contents of the MASK, TABS, and BOUNDS lines, 
together with the COLS positioning line. The MASK and TABS lines 
are not displayed if they contain all blanks, and the BOUNDS line 
is not displayed if it contains the default boundary posi ti ons. 

If the "name" operand is typed, and if the user already has a pro- 
file of that name, edit immediately switches to the specified pro- 
file and displays it. (Display of the profile may be avoided by 
typing a zero for the "number" operand. See below.) If a profile 
of the specified name does not already exist, a new profile is 
defined with that name. The initial content of the new profile is 
the same at the profile which was in effect when the PROFILE com- 
mand was entered. 

The "number" operand controls the number of lines shown in the 
profile display. If the number is typed, it prevents display of 
the profile. If the number 7 is typed, it forces display of all 
lines, even if the MASK and TABS are blanks and BOUNDS contains 
the defaults. 

Use of profiles may also be controlled from the edit data set 
menu. If the profile name field is left blank, the profile name 
defaults to the data set "type" (last qualifier in the data set 
name). If a name is entered, it overrides the "type" qualifier. 
In either case, if a profile of that name currently exists, it is 
used. If it does not exist, a new profile is defined. The ini- 
tial content of the new profile has the default mode settings (see 
"Edit Modes and Profiles"), all-blank MASK and TABS, and default 
BOUNDS. 
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EDIT -- 
COMMAND 


- SPFDEMO. SAMPLE. PLKBROPDS) - 01.02 ■ 
INPUT ===> _ 










SCROLL ===> HALF 





****** 


************************* TOP OF DATA 


********************************** 


=PROF> 
=PROF> 
=PROF> 
000700 


PLI (FIXED - 80) RECOVERY OFF. 

CAPS ON HEX OFF.. ..NULLS OFF.. 

AUTONUM ON. -...PRINT OFF STATS < 

^INCLUDE SYSLIB(BROLISTM); 


. . .NUME 
. . TABS 
3N... . 


>ER ON STD 




OFF 




> 






/* 


LIST MEMBER NAMES 


*/ 




000300 


END; 


/* 




*/ 




000900 


ELSE 


/* 


ELSE, 


*/ 




001000 


DO; 


/* 




*/ 




001100 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ 




001200 


BROSMEMB = BROMMEMB; 


/* 


MOVE MEMBER NAME TO 


*/ 




001300 


END; 


/* 


'SELECTED' MEMBER 


*/ 




001400 


IF BROSMEMB(l) -= ' ' THEN 


/* 


IF MEMBER SELECTED, 


*/ 




001500 


DO; 


/* 




*/ 




001600 


/(INCLUDE SYSLIB(BROFINDM); 


/* 


FIND MEMBER 


*/ 




001700 


IF BRORCODE = THEN 


/* 


IF NO ERRORS, 


*/ 




001800 


DO; 


/* 




*/ 




001900 


^INCLUDE SYSLIB(BROPDSH);/* 


SET UP PDS HEADER 


*/ 




002000 


CALL CBRO (TLD,TDC); 


/* 


CALL COMMON BROWSE 


*/ 




002100 


END; 


/* 




*/ 




002200 


ELSE 


/* 


ELSE, 


*/ 




002300 


DO; 


/* 




*/ 




002400 


BROMLIST = OFF; 


/* 


TURN OFF LIST FLAG 


*/ 




002500 


BROSMEMB = BLANKS; 


/* 


CLEAR SEL. MEMBER 


*/ 




002600 


END; 


/* 




*/ 




002700 


END; 


/* 




*/ 




002800 


ELSE 


/* 


ELSE (NOTHING SELECTED) 


,*/ 



Figure 41. Edit - Profile Display 
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Hexadecimal Display 



When edit is operating in HEX mode, three lines are displayed for 
each source line. The first line shows the data in standard char- 
acter form. The following two lines show the same data in 
hexadecimal representation. See Figure 42. 

Any invalid (non-di splayable) characters may be changed by ovei — 
typing the hexadecimal representations. Any valid character may 
be changed by overtyping either the standard character represent- 
ations or the hexadecimal representations. 

Note : The FIND and CHANGE commands may also be used to find and 
change invalid characters or any specific hex character, regard- 
less of the setting of HEX mode. See discussion of picture 
strings and hex strings under FIND and CHANGE commands. 

HEX mode may be turned on or off by using the HEX command. Format: 



HEX CON/OFF] [VERT/DATA] 



The operands may be typed in any order, 
omitted, ON is the default. 



If the ON/OFF operand is 



The VERT (vertical) and DATA operands are valid only when HEX mode 
is turned on. VERT causes the hexadecimal representations to be 
displayed vertically (two rows p<zr byte) under each character. 
DATA causes the hexadecimal representations to be displayed as a 
string of hex characters (two per byte), as shown in Figure 42. 
Since the hex string is twice as long as the data string, it con- 
sumes two rows. If this operand is omitted, VERT is the default. 



EDIT SPFDEMO. SAMPLE. PLKBROPDS) - 01.02 COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===> HALF 

000700 ^INCLUDE SYSLIB(BROLISTM); /* LIST MEMBER NAMES */ 

40404040404040404040406CC9D5C3D3E4C4C540E2E8E2D3C9C24DC2D9D6D3C9E2E3045D 
5E404040615C4040404040D3C9E2E340D4C5D4C2C5D940D5C104C5E240404040405C6140 

000800 END; /* */ 

404040404040404040C5D5C45E4040404040404040404040404040404040404040404040 
40404040615C404040404040404040404040404Q404040404040404040404040405C6140 

000900 ELSE /* ELSE, */ 

40404040404040C5D3E2C540404040404040404040404040404040404040404040404040 
40404040615C404040C5D3E2C56B404040404040404040404040404040404040405C6140 

001000 DO; /* */ 

404040404040404040C4D65E404040404040404040404040404040404040404040404040 
40404Q40615C4040404040404040404040404040404040404040404040404040405C6140 

001100 BROMLIST = OFF; /* TURN OFF LIST FLAG */ 

4040404040404040404040C2D9D6D4D3C9E2E3407E40D6C6C65E40404040404040404040 
40404040615C4040404040E3E4D9D54QD6C6C64QD3C9E2E340C6D3C1C7404040405C6140 

001200 BROSMEMB = BROMMEMB; /* MOVE MEMBER NAME TO */ 

4040404040404040404040C2D9D6E2D4C504C2407E40C2D9D6D4D4C5D4C25E4040404040 
40404040615C4040404040D4D6E5C540D4C5D4C2C5D940D5C1D4C540E3D64040405C6140 

001300 END; /* 'SELECTED' MEMBER */ 

404040404040404040C5D5C45E4040404040404040404040404040404040404040404040 



Figure 42. Edit - Hexadecimal Display, Data 
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TEXT PREPARATION FEATURES 

The following commands are described in the section: 

Primary command: CAPS 

Line commands: TE (text entry) 

TS (text split) 

TF (text flow) 

(overlay) 

Character Translation 

If CAPS mode is on, alphabetic data entered at the terminal is 
automatically translated to upper case during edit operations. 
If CAPS mode is off, alphabetic data is left "as is". CAPS mode 
is normally on except when documentation (text) is being edited. 

CAPS mode also determines whether character strings, entered as 
operands of the FIND and CHANGE commands, are translated to upper 
case. Note that the keyword operands and all menu parameters are 
always translated to upper case regardless of the current setting 
of CAPS mode. 

CAPS mode may be turned on or off by using the CAPS command. 
Format: 



CAPS CON/OFF] 



If the operand is omitted, ON is the default. 

Whenever data is fetched for editing, SPF will initialize the set- 
ting of CAPS mode based on whether the data does or does not con- 
tain lower case alphabetics. If the initial setting of CAPS mode 
differs from the previous setting in the profile, a message will 
be displayed indicating that edit has changed the mode. For new 
members or empty sequential data sets, the initial setting of CAPS 
mode is unchanged from whatever is in the profile. The default 
for a new profile is CAPS mode ON. 



Text Entry and Edit 



All of the edit line and primary commands may be used when entei — 
ing and editing text information. Three additional line commands 
&r& provided specifically for this purpose: 

TE - Text Entry 
TS - Text Split 
TF - Text Flow 

These commands are described in the following sections. 



> 
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Text Entry 



The text entry command is intended for bulk entry of text using 
power typing techniques. When the characters "TE" are entered in 
a line command area, blank lines are inserted starting with the 
line following the "TE". A number may follow the "TE" to indicate 
the number of blank lines to be inserted. If the number is omit- 
ted, sufficient blank lines ar& inserted to fill the screen from 
the line following the "TE" to the end of the screen. 



TE - Text entry (to end of screen) 
TEn - Text entry "n" lines 



The user may type information on the blank lines without regard to 
line &nd. The line command area on the blank lines is protected, 
and automatic cursor skip is provided from the end of one line to 
the first data position on the next line. When the ENTER key is 
pressed, the new information is automatically ref lowed to fit 
within the currently defined boundaries (see BOUNDS line 
command), and any unused blank lines at the end of the new text 
are deleted. 

If insufficient blank lines have been generated, the keyboard 
will lock when the user attempts to type beyond the last character 
position of the last blank line. A vertical bar (|) will be dis- 
played above the cursor at the locked position. To generate more 
blank lines, press the RESET key to unlock the keyboard and then 
press the ENTER key. 

Multiple paragraphs may be entered by using either of the follow- 
i ng techni ques: 

• leave a blank line between paragraphs, or 

• indent the start of a new paragraph with three or more blank 
(space) characters. 

Note: Tab definitions are not functional during text entry. 



Text Split 



The text split command allows insertion of new material into 
existing text. To split a line, enter the characters "TS" in a 
line command area and then move the cursor to the desired split 
point (on the same line) before pressing the ENTER key. A new 
line is inserted following the line containing the "TS". Text to 
the right of the cursor, up to and including the current right 
boundary column, is is moved to the next line (following the 
inserted line) and positioned at the current left boundary col- 
umn. See BOUNDS line command for definition of boundary columns. 

A number may follow the "TS" to cause additional lines to be 
inserted. 



TS - Text split and insert line 

TSn - Text split and insert "n" lines 



Figure 43 shows a before-and-after example of line splitting, 
where "TS3" was entered on line 60 and the cursor was positioned 
following the word "text". 

Automatic cursor skip is not provided from the end of one line to 
the next when the "TS" command is used. The line command areas on 
the new line(s) are unprotected and may be used to enter line 
commands, as usual. 
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EDIT — SPFDEMO SCRIPT CI COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===> HALF 

000056 

000057 CH6.TEXT SPLIT 

000058 

000059 THE TEXT SPLIT COMMAND IS INTENDED FOR INSERTION OF NEW MATERIAL INTO 

TS3 EXISTING TEXT. _TO SPLIT A LINE, ENTER THE CHARACTERS "TS" IN A LINE 

000061 COMMAND AREA AND THEN MOVE THE CURSOR TO THE DESIRED SPLIT POINT (ON THE 

000062 SAME LINE) BEFORE PRESSING THE ENTER KEY. A NEW LINE IS INSERTED 

000063 FOLLOWING THE LINE CONTAINING THE "TS", AND ALL TEXT TO THE RIGHT OF THE 

000064 CURSOR IS MOVED TO THE BEGINNING OF THE NEXT LINE (FOLLOWING THE 

000065 INSERTED LINE). A NUMBER MAY FOLLOW THE "TS" TO CAUSE ADDITIONAL LINES 

000066 TO BE INSERTED. 
000067 



- TEXT SPLIT AND INSERT LINE 

- TEXT SPLIT AND INSERT "N" LINES 



000075 CFIGREF REFID='ETS'. SHOWS A BEFORE-AND-AFTER EXAMPLE OF LINE 

000076 SPLITTING, WHERE "TS3" WAS ENTERED ON LINE 60 AND THE CURSOR WAS 

000077 POSITIONED FOLLOWING THE WORD "TEXT". 
000078 

000079 AUTOMATIC CURSOR SKIP IS CHP1.NOTCEHP1 . PROVIDED FROM THE END OF ONE 

000080 LINE TO THE NEXT WHEN THE "TS" COMMAND IS USED. THE LINE COMMAND AREAS 

000081 ON THE NEW LINE(S) ARE UNPROTECTED AND MAY BE USED TO ENTER LINE 



000068 


.FO 


OFF 


000069 


.BX 


9 72 


000070 




TS 


000071 




TSN 


000072 


.BX 


OFF 


000073 


.FO 


ON 


000074 







) 



> 



EDIT SPFDEMO SCRIPT CI - 

COMMAND INPUT ===> 

000056 

000057 CH6.TEXT SPLIT 

000058 

000059 THE TEXT SPLIT COMMAND 

000060 EXISTING TEXT. 



COLUMNS 001 072 
SCROLL ===> HALF 



IS INTENDED FOR INSERTION OF NEW MATERIAL INTO 



000064 
000065 
000066 
000067 
000068 
000069 
000070 
000071 
000072 
000073 
000074 
000075 
000076 
000077 
000078 
000079 
000080 
000077 



TO SPLIT A LINE, ENTER THE CHARACTERS "TS" IN A LINE 

COMMAND AREA AND THEN MOVE THE CURSOR TO THE DESIRED SPLIT POINT (ON THE 
SAME LINE) BEFORE PRESSING THE ENTER KEY. A NEW LINE IS INSERTED 
FOLLOWING THE LINE CONTAINING THE "TS", AND ALL TEXT TO THE RIGHT OF THE 
CURSOR IS MOVED TO THE BEGINNING OF THE NEXT LINE (FOLLOWING THE 
INSERTED LINE). A NUMBER MAY FOLLOW THE "TS" TO CAUSE ADDITIONAL LINES 
TO BE INSERTED. 



.FO OFF 

.BX 9 72 
TS 
TSN 

.BX OFF 

.FO ON 



- TEXT SPLIT AND INSERT LINE 

- TEXT SPLIT AND INSERT "N" LINES 



CFIGREF REFID='ETS'. SHOWS A BEFORE-AND-AFTER EXAMPLE OF LINE 
SPLITTING, WHERE "TS3" WAS ENTERED ON LINE 60 AND THE CURSOR WAS 
POSITIONED FOLLOWING THE WORD "TEXT". 
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Figure 43. Edit - Text Split Example 
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The text split command may also be used in conjunction with other 
line commands to move or copy text. Use "TS" at the end points of 
the material to be moved or copied (i.e., to break it out so that 
is is wholly contained on one or more lines). In addition, use 
"TS" at the insertion point to open up space. Then use the stand- 
ard move ("M" or "MM") or copy ("C" or "CC") line command together 
with the after ("A") or before ("B") line command. 

Figure 44 shows art example of a sentence to be moved from one par- 
agraph to another. In the first part of the figure, the sentence 
on lines 33-35 has already been split out by using the "TS" com- 
mand twice (once with the cursor at the begi rtni rig of the sentence, 
and again at the end of the sentence). Another "TS" command is 
now entered on line 44 to split the second paragraph at the desti- 
nation point for the move. The second part of the figure shows 
the use of "MM" and "A" to accomplish the move. 
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COLUMNS 001 072 
SCROLL ===> HALF 



EDIT SPFDEMO SCRIPT CI 

COMMAND INPUT ===> 
000030 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 

000032 END. 

000033 THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 

000035 DATA POSITION ON THE NEXT LINE. 

I Mill 

000037 

000038 

000039 

000040 

000041 

000042 

000043 

TS 

000045- 

000046 

000047 

000048 

000049 

000050 

000051 

000052 

000053 

000054 

000055 



WHEN THE ENTER KEY IS PRESSED, THE NEW 

INFORMATION IS AUTOMATICALLY REFLOWEO TO FIT WITHIN THE CURRENTLY 
DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
AT THE END OF THE NEW TEXT ARE DELETED. 

IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 
WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
LAST BLANK LINE. A VERTICAL BAR (I) WILL BE DISPLAYED ABOVE THE CURSOR 
AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 
KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 

MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 
TECHNIQUES: 

CUL 

CLI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

C LI. INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 

CHARACTERS. 

CEUL 










COLUMNS 001 072 
SCROLL ===> HALF 



EDIT — SPFDEMO SCRIPT CI 

COMMAND INPUT ===> 
000030 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 

000032 END. 

MM THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 

MM DATA POSITION ON THE NEXT LINE. 

000036 WHEN THE ENTER KEY IS PRESSED, THE NEW 

000037 INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 

000038 DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 

000039 AT THE END OF THE NEW TEXT ARE DELETED. 
000040 

000041 IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 

000042 WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 
A LAST BLANK LINE. 

000044 

000045 A VERTICAL BAR ( I ) WILL BE DISPLAYED ABOVE THE CURSOR 

000046 AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 

000047 KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 
000048 

000049 MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 

000050 TECHNIQUES: 
000051 

000052 CUL 

000053 CLI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

000054 CLI. INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 

000055 CHARACTERS. 
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Figure 44. Edit - Move Sentence Example 
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Text Flow 



The text flow command may be used to reflow paragraphs following 
deletions, insertions, splitting, etc. When the characters "TF" 
are entered in a line command area, the text i s ref lowed from the 
beginning of that line to the end of the paragraph. 



TF .- Text flow (between current bounds) 

TFn * Text flow from left bound to column "n" 



The reflow operation will remove trailing blanks on a line by 
pulling in material from the following line. It will not, howev- 
er, remove embedded blanks within a line. Accordingly, if one or 
more words in a line are to be deleted, the 3270 DELETE key should 
be used (rather than overtyping the words with blanks). 

The text to be flowed i s taken from within the currently defined 
column boundaries (see BOUNDS line command). Any text outside the 
bounds does not participate in the flow operation. The ref lowed 
text is also positioned within the current bounds. If the ori- 
ginal text was indented from the left boundary, the indentation is 
preserved. 

Each line of the ref lowed text normally extends to the right 
boundary position. However, the text may be "squeezed up" by 
entering a number after the "TF" command. The number specifies 
the right-most column post ion for the ref lowed text. It must be 
less than the current setting of the right bound (otherwise, it is 
i gnored) . 

A before and after example of text flow is shown in Figure 45. 
The bounds are set at 1 and 72. A "TF50" command is entered on 
line 41. All text between 1 and 72 participates in the flow, but 
the results sre contained within columns 1 and 50. 



Use of Program Function Keys for Text Commands 

Whenever heavy use is being made of the text line commands, it is 
strongly recommended that both the text split and text flow com- 
mands be assigned to program function (PF) keys. For users of 
12-key terminals, infrequently used PF keys such as Shift Right 
and Shift Left may be reassigned to these functions. Use SPF 
Parms (option 0.3) to reassign the keys. Example: 

PF10 ===> :TS 
PF11 ===> :TF 

With these key definitions, a text split may be accomplished by 
moving the cursor to the desired split point (within a line) and 
pressing PF10. After the new material has been typed, PF11 may be 
pressed to reflow the text from the line containing the cursor to 
the end of the paragraph. 
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COLUMNS 001 072 
SCROLL ===> HALF 



EDIT — SPFDEMO SCRIPT CI 

COMMAND INPUT ===> 
000030 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 

000032 END. 

000033 THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 

000035 DATA POSITION ON THE NEXT LINE. 

000036 WHEN THE ENTER KEY IS PRESSED, THE NEW 

000037 INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 

000038 DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 

000039 AT THE END OF THE NEW TEXT ARE DELETED. 
000040 

TF50_ IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, THE KEYBOARD WILL LOCK 

000042 WHEN THE USER ATTEMPTS TO TYPE BEYOND THE LAST CHARACTER POSITION OF THE 

000043 LAST BLANK LINE. A VERTICAL BAR ( I ) WILL BE DISPLAYED ABOVE THE CURSOR 

000044 AT THE LOCKED POSITION. TO GENERATE MORE BLANK LINES, PRESS THE RESET 

000045 KEY TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER KEY. 
000046 

000047 MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 

00004S TECHNIQUES: 

000049 

000050 CUL 

000051 CLI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

000052 CLI. INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 

000053 CHARACTERS. 

000054 CEUL 
000055 



) 







D> 



EDIT SPFDEMO SCRIPT CI COLUMNS 001 072 

COMMAND INPUT ===> SCROLL ===> HALF 

000030 

000031 THE USER MAY TYPE INFORMATION ON THE BLANK LINES WITHOUT REGARD TO LINE 

000032 END. 

000033 THE LINE COMMAND AREA ON THE BLANK LINES IS PROTECTED, AND 

000034 AUTOMATIC CURSOR SKIP IS PROVIDED FROM THE END OF ONE LINE TO THE FIRST 

000035 DATA POSITION ON THE NEXT LINE. 

000036 WHEN THE ENTER KEY IS PRESSED, THE NEW 

000037 INFORMATION IS AUTOMATICALLY REFLOWED TO FIT WITHIN THE CURRENTLY 
000036 DEFINED BOUNDARIES (SEE BOUNDS LINE COMMAND), AND ANY UNUSED BLANK LINES 
000039 AT THE END OF THE NEW TEXT ARE DELETED. 

000040 

000041 IF INSUFFICIENT BLANK LINES HAVE BEEN GENERATED, 

000042 THE KEYBOARD WILL LOCK WHEN THE USER ATTEMPTS TO 

000043 TYPE BEYOND THE LAST CHARACTER POSITION OF THE 

000044 LAST BLANK LINE. A VERTICAL BAR (I) WILL BE 

000045 DISPLAYED ABOVE THE CURSOR AT THE LOCKED POSITION. 

000046 TO GENERATE MORE BLANK LINES, PRESS THE RESET KEY 

000047 TO UNLOCK THE KEYBOARD AND THEN PRESS THE ENTER 

000048 KEY. 
000049 

000050 MULTIPLE PARAGRAPHS MAY BE ENTERED BY USING EITHER OF THE FOLLOWING 

000051 TECHNIQUES: 
000052 

000053 «UL 

000054 < LI. LEAVE A BLANK LINE BETWEEN PARAGRAPHS, OR 

000055 <LI. INDENT THE START OF A NEW PARAGRAPH WITH THREE OR MORE BLANK (SPACE) 



Figure 45. Edit - Text Flow Example 
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Overlaying Lines 



The overlay line ("0" or "00") command allows a list of items to 
be rearranged in multi-column (tabular) format. The overlay com- 
mand may be used with the move line CM" or "MM") or copy line 
("C" or "CC") line commands. It is used in place of the after 
("A") command. 

The character "0" may be entered in a line command area to specify 
the line over which data is to be moved or copied. A number may 
follow the "0" to indicate the number of lines to be overlayed. A 
block of lines to be overlayed may be specified by entering "00" 
on the first and last lines of the block. 



- Overlay line 

On - Overlay "n" lines 

00 - Overlay block of lines 



Blank characters in the receiving line(s), specified with "0" or 
"00", are overlayed with corresponding characters from the source 
line(s), specified with "M", "MM", "C", or "CC". Non-blank char- 
acters are not overlayed. 

Only those characters which are within the current column bounda- 
ries participate in the overlay operation (see description of 
BOUNDS command). 

The number of source and receiving lines need not be the same. If 
there are more receiving lines, the source lines are repeated 
until the receiving lines are used up. If there are more source 
lines, the extra source lines are ignored. 

Only data lines participate in the overlay operation. Special 
lines such as MASK, TABS, BOUNDS, and COLS are ignored as either 
source or receiving lines. 

A before and after example of overlaying lines is shown in 
Figure 46. Generally, a list such as that shown in the figure 
would be maintained and edited as a single column (left adjusted). 
Prior to the overlay, portions of the list would be right-shifted 
by the appropriate amounts to overlay in the multi-column format. 
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COMMAND 
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~ OrrUCVuL»rKr 

INPUT ===> 








SCROLL ===> HALF 


\> 


000035 














00 


GENERAL COMMANDS: 










000037 
















000038 


COLS 














000039 


I, IN 




(INSERT) 










000040 


D, DN, DO 




(DELETE) 










000041 


R, RN, RR, 


RRN 


(REPEAT) 










000042 


M, MN, MM 




(MOVE) 










000043 


C, CN, CC 




( COPY ) 








D> 


000044 


A 




(AFTER) 








00 


B 




(BEFORE) 








t> 


000046 














MM 












ADVANCED FEATURES: 


000048 
















000049 












MASK 




000050 












<, <N, «, «N (DATA LEFT) 




000051 












>, >N, », »N (DATA RIGHT) 




000052 












(» (N, ((> ((N (COLUMNS LEFT) 




000053 












), )N, )), ))N (COLUMNS RIGHT) 




000054 












BOUNDS 




000055 














> 


MM_ 














****** 


*************************** 


BOTTOM OF 


DATA ***************************** 



> 



> 



EDIT — 
COMMAND 


- SPFDEVEL.PRM.SCRIPT(DEMO) 
INPUT ===> 




SCROLL ===> HALF 


000035 








000036 


GENERAL COMMANDS: 




ADVANCED FEATURES: 


000037 








000038 


COLS 




MASK 


000039 


I, IN 


(INSERT) 


<, <N, «, «N (DATA LEFT) 


000040 


D, DN, DD 


(DELETE) 


>, >N, », »N (DATA RIGHT) 


000041 


R, RN, RR, RRN 


(REPEAT) 


(, (N, ((, ((N (COLUMNS LEFT) 


000042 


M, MN, MM 


( MOVE ) 


), )N, )), ))N (COLUMNS RIGHT) 


000043 


C, CN, CC 


( COPY ) 


BOUNDS 


000044 


A 


(AFTER) 




000045 


B 


(BEFORE) 




000046 








****** 


*************************** 


BOTTOM OF DATA ***************************** 

\ 



Figure 46. Edit - Overlay Line Example 
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UTILITIES (OPTION 3) 



The utility option provides a variety of functions for SPF 
library and file maintenance* moving and copying data, printing 
or displaying SPF project listings, resetting SPF library statis- 
tics, initiating spool output, retrieving data from the virtual 
reader, retrieving SPF libraries (via tape) from a TSO system, and 
formatting SCRIPT/VS documentation. 

The uti li ty selecti on menu is shown in Figure 47. 



SELECT OPTION ===> 



UTILITY SELECTION MENU 



1 LIBRARY 



2 FILE 



3 


MOVE/COPY 


4 


PROJECT 


5 


RESET 


6 


SPOOL 


7 


READER 


8 


RETRIEVE 


9 


SCRIPT/VS 



LIBRARY UTILITY: 

PRINT INDEX LISTING OR ENTIRE FILE 
PRINT, RENAME, DELETE, OR BROWSE MEMBERS 
COMPRESS SPF LIBRARY OR CMS MACLIB 

FILE UTILITY: 

SPECIFY OR UNSPECIFY SPF LIBRARY 

DISPLAY SPF LIBRARY OR CMS FILE INFORMATION 

RENAME OR DELETE SPF LIBRARY OR CMS FILE 

MOVE OR COPY MEMBERS OR FILES 

PRINT OR DISPLAY SPF PROJECT LIBRARIES 

RESET STATISTICS FOR MEMBERS OF SPF LIBRARY 

INITIATE SPOOL OUTPUT 

RETRIEVE BATCH OUTPUT FROM READER 

RETRIEVE SPF/TSO LIBRARIES FROM TAPE 

FORMAT, DISPLAY, AND OPTIONALLY PRINT SCRIPT TEXT 



Figure 47. Utility Selection Menu 



For each of the utility options, a panel is displayed that allows 
the user to select a function and enter the appropriate library or 
file information. These panels allow both option selection and 
data entry in a single panel format. 



The following describes each of the utility 
sponding to each option on the secondary menu. 



functions, corre- 
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LIBRARY UTILITY (OPTION 3.1) 



When this option is selected, a panel is displayed that allows the 
user to specify a library or file and indicate an action to be 
performed (Figure 48). Possible actions are: 

C - Compress SPF library or CMS MACLIB 

X - Print index listing 

L - Print SPF library or CMS file 

P - Print member 

R - Rename member 

D - Delete member 

B - Browse member 

blank - Display member list 

Note ; The library utility is intended primarily for maintenance 
of SPF libraries, MACLIBs, and TXTLIBs, but the "print index list- 
ing" and "print SPF library or CMS file" functions also apply to 
sequential CMS files. 





SELECT OPTION ===> _ 




C - COMPRESS SPF LIBRARY OR CMS MACLIB P - 


PRINT MEMBER 


X - PRINT INDEX LISTING R - 


RENAME MEMBER 


L - PRINT SPF LIBRARY OR CMS FILE D - 


DELETE MEMBER 


BLANK - DISPLAY MEMBER LIST B - 


BROWSE MEMBER 


SPF LIBRARY: 




PROJECT ===> SPFDEMO 




LIBRARY ===> XXX 




TYPE —=> COBOL 




MEMBER ===> (IF OPTION "P", "R", "D", 


OR "B" SELECTED) 


NEWNAME ===> (IF OPTION "R" SELECTED) 




CMS FILE: 




FILE ID ===> 




MEMBER ===> (IF OPTION "P", "R", "D", 


OR "B" SELECTED) 


NEWNAME ===> (IF OPTION "R" SELECTED) 




IF NOT LINKED, SPECIFY: 




OWNER'S ID ===> DEVICE AODR. ===> 


LINK ACCESS MODE ===> 


READ PASSWORD ===> UPDATE PASSWORD ===> 





Figure 48. Library Utility Panel 



If option "C" (compress SPF library or CMS MACLIB) is selected, 
any MACLIB (including an SPF library with a MACLIB organization) 
may be specified. The compress is accomplished by invoking the 
MACLIB command. 



P 



If option "X" (print index listing) is selected, any SPF library 
or CMS file may be specified. The index listing is recorded in 
the SPF list file. For SPF libraries, MACLIB's, and TXTLIBs, the 
index listing includes general information about the library fol- 
lowed by a member list. For a sequential CMS file, the index 
listing includes general information only. See Appendix C for an 
example of index listing format. 
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If option "L" (print SPF library or CMS file) is selected, any SPF 
library or CMS file may be specified. A source listing of the 
entire file (including all members) ,■ preceded by an index list- 
ing, is recorded in the SPF list file. 

If option "P" (print member) is selected, a member of any SPF 
library, MACLIB, or TXTLIB may be specified. A source listing of 
the member is recorded in the SPF list file. 

If option "R" or option "D" (rename member or delete member) is 
selected, a member of any SPF library, MACLIB, or TXTLIB may be 
specified. A new member name must also be specified for the "re- 
name member" function. 

If option "B" (browse member) is selected, a member of any SPF 
library, MACLIB, or TXTLIB may be speci fi ed. The speci fi ed member 
will be displayed in browse mode. All browse commands can be exe- 
cuted. When browse is terminated by pressing the End PF key, the 
library utility panel will be redisplayed. 

If no option is specified (blank to display member listing), any 
SPF library, MACLIB, or TXTLIB may be specified. A member listing 
is then displayed from which the user may select members for 
printing, renaming, deleting, or browsing by entering "P", "R", 
"D", or "B" respectively in front of one or more member names. For 
renaming, a new member name must also be entered in the field 
immediately following the current member name. The member list 
may be scrolled up and down via the scroll PF keys or via the 
LOCATE command. The member list may be terminated by pressing the 
End PF key. 

Figure 49 shows a before-and-af ter example where members ACCT1 
and ACCT2 are printed, member UPDATE is deleted, and member 
LISTNEW is renamed LISTOUT. 
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UTILITIES -~ ■ SPFDEMO.MYLIB. 
COMMAND INPUT ===> 



PLI 



NAME 
ACCOUNT 
ACCT1 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTNEW 
MAIN 
TESTDIR 
UPDATE 
**END** 



RENAME 



LISTOUT 



VER.MOD 
01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 
01.00 



CREATED 
79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/04/23 
79/01/09 



LAST MODIFIED 
79/01/09 17:07 
79/04/23 14:52 
79/01/09 17:07 
79/04/24 16:20 
79/01/09 17:08 
79/01/14 12:30 
79/04/23 15:14 
79/04/23 15:00 
79/01/09 17:08 
79/05/06 17:04 
79/01/09 17:08 





SCROLL == 


=> PAGE 


SIZE 


INIT 


MOD 


ID 


21 


21 





KLEIN 


99 


193 





KLEIN 


20 


20 





ORR 


19 


19 


4 


ORR 


44 


44 





ORR 


13 


13 


1 


ORR 


20 


20 





MOSTON 


17 


13 


6 


KLEIN 


4 


4 





MOSTON 


30 


43 


10 


MOSTON 


13 


13 





MOSTON 



UTILITIES SPFDEMO.MYLIB. 

COMMAND INPUT ===> 



PLI 



NAME 


RENAME 


VER.MOD 


CREATED 


ACCOUNT 




01.00 


79/01/09 


ACCT1 


SPRINTED 


01.01 


79/01/09 


ACCT2 


^PRINTED 


01.00 


79/01/09 


COINS 




01.04 


79/04/24 


COMPX 




01.00 


79/01/09 


COMPY 




01.01 


79/01/14 


DCLS 




01.00 


79/04/23 


LISTNEW 


^RENAMED 


01.02 


79/04/23 


MAIN 




01.00 


79/01/09 


TESTDIR 




01.04 


79/04/23 


UPDATE 


^DELETED 


01.00 


79/01/09 


**END** 









LAST MODIFIED 
79/01/09 17:07 
79/04/23 14:52 
79/01/09 17:07 
79/04/24 16:20 
79/01/09 17:08 
79/01/14 12:30 
79/04/23 15:14 
79/04/23 15:00 
79/01/09 17:08 
79/05/06 17:04 
79/01/09 17:08 





SCROLL == 


=> PAGE 


SIZE 


INIT 


MOD 


ID 


21 


21 





KLEIN 


99 


193 





KLEIN 


20 


20 





ORR 


19 


19 


4 


ORR 


44 


44 





ORR 


13 


13 


1 


ORR 


20 


20 





MOSTON 


17 


13 


6 


KLEIN 


4 


4 





MOSTON 


30 


43 


10 


MOSTON 


13 


13 





MOSTON 



I 



Figure 49. Library Utility - Print* Rename, and Delete 
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FILE UTILITY (OPTION 3.2) 



When this option is selected, a panel is displayed that allows the 
user to specify a library or file and indicate an action to be 
performed (Figure 50). Possible actions are: 

S - Specify new SPF library 

U - Unspecify an SPF library 

R - Rename file or SPF library 

D - Delete ("erase") file or SPF library 

blank - Display file or SPF library information 

For options "S" and "U", an SPF library identification (project, 
library, and type) must be specified. For the other options, any 
SPF library or CMS file may be specified. 



FILE UTILITY 



SELECT OPTION ===> 



S - SPECIFY NEW SPF LIBRARY 

U - UNSPECIFY AN SPF LIBRARY 

R - RENAME SPF LIBRARY OR CMS FILE 

D - DELETE SPF LIBRARY OR CMS FILE 

BLANK - DISPLAY SPF LIBRARY OR CMS FILE INFORMATION 

SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ===> PLI 



CMS FILE: 

FILENAME ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> 



READ PASSWORD ===> 



DEVICE ADDR. ===> LINK ACCESS MODE 
UPDATE PASSWORD ===> 



Figure 50. File Utility Panel 



If option "S" (specify new SPF library) is selected, a panel is 
displayed to allow specification of SPF library attributes and 
location (minidisk), link access mode for update, and correspond- 
ing CMS f i letype/f i lename (Figure 51). Default values are 
pre-entered based on what the user last entered, or based on the 
last "display file information" request (whichever occurred most 
recently). The user may overtype the displayed defaults. When the 
ENTER key is pressed, the new library is specified. Pressing the 
End PF key causes a return to the previous panel without perform- 
ing the library specification. 




See Appendix B for guidelines in specifying SPF libraries. 
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SPF LIBRARY NAME: NEWPRO J . MASTER 


•ASSEMBLE 




SPF LIBRARY ATTRIBUTES: 






ORGANIZATION ===> S 


(S = SET OF FILES, M = MACLIB 


T = TXTLIB) 


RECORD FORMAT ===> F 


(F = FIXED, V = VARIABLE) 




RECORD LENGTH ===> 80 


(1 - 32767 BYTES) 




SPF LIBRARY LOCATION: 






OWNER'S ID ===> STEPHENS 


(BLANK FOR YOUR USERID) 




DEVICE ADDR. ===> 5FE 


(BLANK FOR '191') 




LINK ACCESS MODE FOR UPDATE: 






MODE LETTERS ===> M__ 


(M, W, OR MM) 




FOR ORGANIZATION S (SET OF FILES): 




FILETYPE ===> 


(BLANK CAUSES SPF TO GENERATE 


A NAME) 


FOR ORGANIZATION M OR T (MACLIB 


OR TXTLIB): 




FILENAME ===> 


(BLANK CAUSES SPF TO GENERATE 


A NAME) 



Figure 51. File Utility - Specify New SPF Library 



If option "U" (unspecify SPF library) is selected, a confirmation 
panel is displayed to ensure that the user did not select this 
option by mistake. As directed in the panel, the user must then 
press either the ENTER key to confirm or the End PF key to cancel. 
Either action causes a return to the previous panel. 

Option "U" causes the information about the SPF library to be 
purged from the SPF catalog, but it does not cause the associated 
file(s) to be deleted. 

If option "R" (rename file or SPF library) is selected, a panel is 
displayed to allow the user to enter the new file or SPF library 
identification (Figure 52). The user may type the new identifi- 
er^) and press ENTER (to rename), or press the End PF key to 
cancel. Either action causes a return to the previous panel. 

If option "D" (delete file or SPF library) is selected, a confir- 
mation panel is displayed to ensure that the user did not select 
this option by mistake. As directed in the panel, the user must 
then press either the ENTER key to confirm or the End PF key to 
cancel. Either action causes a return to the previous panel. 

If an SPF library is specified, option "D" causes the library to 
be unspecified and the associated file(s) to be deleted (erased). 

If no option is specified (blank to display file or SPF library 
information), the location, characteristics, and current space 
utilisation of the specified library or file are displayed 
(Figure 53). The user may return to the previous panel by pressing 
either the ENTER or End PF key. 



> 
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, RENAME SPF LIBRARY 

SPF LIBRARY NAME: SPFDEMO. XXX. COBOL 

SPF LIBRARY LOCATION: 
OWNER'S ID: SPRINGER 
DEVICE ADDR: 195 

NEW SPF LIBRARY NAME: 
PROJECT ===> _ 
LIBRARY ===> ~" 
TYPE ===> 



Figure 52. File Utility - Rename SPF Library 



_-. SPF LIBRARY INFORMATION 

SPF LIBRARY NAME: SPFDEMO. MYLIB.PLI 

SPF LIBRARY ATTRIBUTES: 

ORGANIZATION: M (S = SET OF FILES, M = MACLIB, T = TXTLIB) 
RECORD FORMAT: F (F = FIXED, V = VARIABLE) 
RECORD LENGTH: 80 

SPF LIBRARY LOCATION: 
OWNER'S ID: STEPHENS 
DEVICE ADDR: 5FE 

SPF LIBRARY ACCESSIBILITY: 

LINK ACCESS MODE FOR UPDATE: MM 

EQUIVALENT FILE DATA: 

CMS FILE ID: DEMOPLI MACLIB 



Figure 53. File Utility - Display Information 
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MOVE/COPY UTILITY (OPTION 3.3) 

When this option is selected, a panel is displayed that allows the 
user to specify the "from" library or file (and member if it i s an 
SPF library, MACLIB, or TXTLIB), and to indicate an action to be 
performed (Figure 54 top). Possible actions are: 

CP - Copy file or member(s) and print 

MP - Move file or member(s) and print 

C - Copy without printing 

M - Move without printing 

When ENTER is pressed, a second panel is displayed that allows the 
user to specify the "to" library or file (Figure 54 bottom). The 
following options must also be specified on this panel: 

• Replace like-named members (YES or NO), if the "to" file is an 
SPF library, MACLIB, or TXTLIB. 

• "To" CMS file disposition (OLD or MOD), if the "to" file is 
sequential . 

A disposition of OLD causes an existing file to be rewritten. A 
disposition of MOD causes the "from" data to be appended to the 
end of an existing "to" file. 

Any SPF library or CMS file may be specified for either the "from" 
or "to" file, but the same SPF library, MACLIB, or TXTLIB may not 
be specified as both the "from" and "to" file. 

If the "to" file is a CMS file which does not currently exist, a 
new file will be created with the same attributes as the "from" 
file. If the "to" file is an SPF library, it must have been pre- 
viously specified via option 3.2 (specify SPF library). 

If "move" is indicated and the "from" file is an SPF library, 
MACLIB, or TXTLIB, the selected member(s) will be deleted in the 
"from" file after they have been successfully copied to the "to" 
file. If "move" is indicated and the "from" file is a sequential 
CMS file, the entire "from" file will be deleted after its con- 
tents have been successfully copied to the "to" file. If "copy" 
is indicated, no deletions will occur. 

If "print" is indicated for either move or copy, source listing(s) 
will be recorded in the SPF list file. If the "to" file is an SPF 
library, MACLIB, or TXTLIB, a listing of each new or replaced mem- 
ber will be recorded. If the "to" file is a sequential CMS file, a 
listing of its entire contents will be recorded after the informa- 
tion has been successfully copied. 

The following rules apply for specifying member names if the 
"from" file is an SPF library, MACLIB, or TXTLIB: 

• Specifying a valid "from" member name causes a single member 
to be moved or copied. 

• Leaving the "from" member name blank causes a member listing 
to be displayed (after the second panel has been displayed). 

• Specifying a "from" member name of asterisk (X) causes all 
members to be moved or copied. 

If the "to" file is an SPF library or MACLIB, the "to" member name 
must be specified for the following conditions: 

• The "from" file is a sequential CMS file. 

• A single member is to be moved or copied and the member is to 
be renamed in the "to" file. (Members may also be renamed 
from a member listing — see next paragraph.) 

In all other cases, the "to" member should be left blank. 
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SELECT OPTION ===> C 



MOVE/COPY UTILITY 



CP - COPY FILE OR MEMBER(S) AND PRINT 
MP - MOVE FILE OR MEMBER(S) AND PRINT 



C - COPY WITHOUT PRINT 
M - MOVE WITHOUT PRINT 



SPECIFY "FROM" FILE BELOW, THEN PRESS ENTER TO SPECIFY "TO" FILE 



FROM SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ===> PLI 
MEMBER ===> * 



(BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 



FROM CMS FILE: 
FILE ID ===> 
MEMBER ===> 
IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> 

READ PASSWORD ===> 



(FOR MAC LIB OR TXT LIB) 
DEVICE ADDR. ===> 
UPDATE PASSWORD ===> 



LINK ACCESS MODE ===> 



COPY FROM SPFDEMO. MYLIB. PLH*) 

SPECIFY "TO" FILE BELOW 






TO SPF LIBRARY : 




PROJECT ===> SPFDEMO 




LIBRARY ===> MASTER 




TYPE ="> PLI 




TO CMS FILE: 


FOR NEW CMS FILE: 


FILE ID ===> 


RECFM ===> (F OR V) 


MEMBER ===> 


LRECL ===> 


IF NOT LINKED, SPECIFY: 




OWNER'S ID ===> DEVICE 


ADDR. ===> LINK ACCESS MODE ===> 


UPDATE PASSWORD ===> 




REPLACE LIKE-NAMED MEMBERS ===> YES 


(YES OR NO) 


"TO" CMS FILE DISPOSITION ===> OLD 


(OLD OR MOD) 



Figure 54. Move/Copy Utility Panels 
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A member listing is displayed when the "from" file is an SPF 
library, MACLIB, or TXTLIB, and the "from" member name is left 
blank. The user may select members to be moved or copied by 
entering an "S" in front of one or more member names. The options 
for move or copy, and print or no print must have been previously 
specified on the first move/copy panel. If the "to" file is an SPF 
library or MACLIB, the member(s) may also be renamed by entering a 
new member name in the field immediately following the current 
name. 

The member list may be scrolled up and down via the Scroll PF keys 
or via the LOCATE command. The member list may be terminated by 
pressing the End PF key, which causes a return to the first 
move/copy panel. 

Figure 55 shows a before-and-after example where members ACCOUNT, 
ACCT1, ACCT2, and COMPY are copied to another library, and member 
COMPY is also renamed ZCOMP. 

For any move/copy operation, the following rules apply. 

• If the "to" file is sequential, its entire contents are 
replaced (if disposition OLD was specified) or the new infoi — 
mat ion is added to the end (if disposition MOD was specified). 

• Multiple members of an SPF library, MACLIB, or TXTLIB may be 
moved or copied to a sequential CMS file by using a member 
selection list or by specifying all members (X). The merged 
members appear in the "to" file, replacing the original con- 
tents of the file (if disposition OLD was specified) or added 
to the end (if disposition MOD was specified). 

• If the "to" file is an SPF library, MACLIB, or TXTLIB, new 
members are added except when the member names are alike; 
like-named members are replaced (if replace YES was speci- 
fied) or not copied (if replace NO was specified). 

• Record formats and logical record lengths for the two files 
need not be alike. When necessary, data will be truncated or 
right-padded with blanks to accommodate different record 
lengths. 

• The data to be moved or copied is not renumbered or modified 
in any way, except for possible truncation or padding as noted 
above. Printer control characters, if present, are treated 
as part of the data. 

• SPF library statistics are not modified when moving or copy- 
ing between SPF libraries. 

If the "to" file is a TXTLIB (regardless of whether it is speci- 
fied as an SPF library or a CMS file), SPF invokes the CMS TXTLIB 
command to update the file. The member name in the TXTLIB is 
determined by the TXTLIB command, based on information in the text 
module. The user may not specify a member name (when moving or 
copying from a sequential TEXT file) nor rename the member (when 
moving or copying from a TXTLIB). Any attempt to do so i s ignored. 
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COPY FROM SPFDEMO.MYLIB. 

COMMAND INPUT ===> 



PLI TO SPFDEMO. MASTER. PLI 



NAME 
S ACCOUNT 
S ACCT1 
S ACCT2 

COINS 

COMPX 
S COMPY 

DCLS 

LISTOUT 

MAIN 

TESTDIR 

**END** 



RENAME 



ZCOMP 



VER.MOD 
01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 



CREATED 
79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/04/23 



LAST MODIFIED 
79/01/09 17:07 
79/04/23 14:52 
79/01/09 17:07 
79/04/24 16:20 
79/01/09 17:08 
79/01/14 12:30 
79/04/23 15:14 
79/04/23 15:00 
79/01/09 17:08 
79/05/06 17:04 





SCROLL == 


=> PAGE 


SIZE 


INIT 


MOD 


ID 


21 


21 





KLEIN 


99 


193 





KLEIN 


20 


20 





ORR 


19 


19 


4 


ORR 


44 


44 





ORR 


13 


13 


1 


ORR 


20 


20 





MOSTON 


17 


13 


6 


KLEIN 


4 


4 





MOSTON 


30 


43 


10 


MOSTON 



COPY FROM SPFDEMO.MYLIB. 

COMMAND INPUT ===> 



PLI TO SPFDEMO. MASTER. PLI 



NAME 
ACCOUNT 
ACCT1 
ACCT2 
COINS 
COMPX 
COMPY 
DCLS 
LISTOUT 
MAIN 
TESTDIR 
**END** 



RENAME 
*COPIED 
*COPIED 
*COPIED 



*COPIED 



VER.MOD 
01.00 
01.01 
01.00 
01.04 
01.00 
01.01 
01.00 
01.02 
01.00 
01.02 



CREATED 
79/01/09 
79/01/09 
79/01/09 
79/04/24 
79/01/09 
79/01/14 
79/04/23 
79/04/23 
79/01/09 
79/04/23 



LAST MODIFIED 
79/01/09 17:07 
79/04/23 14:52 
79/01/09 17:07 
79/04/24 16:20 
79/01/09 17:08 
79/01/14 12:30 
79/04/23 15:14 
79/04/23 15:00 
79/01/09 17:08 
79/05/06 17:04 





SCROLL == 


=> PAGE 


SIZE 


INIT 


MOD 


ID 


21 


21 





KLEIN 


99 


193 





KLEIN 


20 


20 





ORR 


19 


19 


4 


ORR 


44 


44 





ORR 


13 


13 


1 


ORR 


20 


20 





MOSTON 


17 


13 


6 


KLEIN 


4 


4 





MOSTON 


30 


43 


10 


MOSTON 



Figure 55. Move/Copy Utility - Copy Members from List 
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PROJECT UTILITY (OPTION 3.4) 



When this option is selected, a panel is displayed that allows the 
user to specify parameters for an SPF library and an action to be 
performed (Figure 56). Possible actions are: 

P - Print project entries 
blank - Display project entries 

Information may be requested for: 

• All SPF libraries known to the system, by specifying an astei — 
i sk (X) for the project name. 

• All SPF libraries with a given project name, by specifying the 
project name and leaving the library name blank. 

• All SPF libraries with a given project and library name. 

If option "P" (print project entries) is selected, a project list- 
ing is recorded in the SPF list file. The listing contains CMS 
file identifications, locations, and file characteristics for 
each SPF library with the specified project name. 

If no option is specified (blank to display project entries), a 
project listing is displayed at the terminal in browse mode. The 
listing may be scrolled up and down via the Scroll PF keys. All 
browse commands may be entered. The listing may be terminated by 
pressing the End PF key, causing a return to the previous panel. 

Figure 57 shows an example of an SPF project listing. 



PROJECT UTILITY 

SELECT OPTION ===> 

P - PRINT PROJECT ENTRIES 
BLANK - DISPLAY PROJECT ENTRIES 



SPF LIBRARY NAME: 

PROJECT ===> SPFDEVEL 
LIBRARY ===> 



( * FOR ALL PROJECTS) 

(BLANK CAUSES ALL LIBRARIES TO BE PROCESSED) 



Figure 56. SPF Project Utility Panel 



) 
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PROJECT LISTING FOR SPFDEVEL 






LINE 00001 COLS 001 080 


COMMAND INPUT ===> _ 










SCROLL = 


==> 


PAGE 


saw****************************** TOP OF DATA 


xxxxxxxxxxxxxxxxxxxxxx-CAPS 


ON-** 


SPF LIBRARY NAME 


FILENAME 


FILETYPE 


USER ID 


VDA 


RECFM 


LRECL 


ORG 


AM 


SPFDEVEL. CV10TPLS.PLI 


CV10TPLI 


MACLIB 


STEPHENS 


193 


F 


80 


M 


MH 


SPFDEVEL.CVIOTTXT.TEXT 


CVIOTTXT 


TXT LIB 


STEPHENS 


193 


F 


80 


T 


mm 


SPFDEVEL. 6032779. MSGS 


SPF0002M 


MACLIB 


ORR 


191 


F 


80 


M 


MM 


SPFDEVEL. G033079.MSGS 


SPF0003M 


MACLIB 


ORR 


191 


F 


SO 


M 


MM 


SPFDEVEL. G041 279. MSGS 


SPF0004M 


MACLIB 


ORR 


191 


F 


80 


M 


MM 


SPFDEVEL. JACK. ASM 


* 


ASSEMBLE 


COSTELLO 


191 


F 


80 


S 


MM 


SPFDEVEL. JACK. COBOL 


* 


COBOL 


COSTELLO 


191 


F 


80 


S 


MM 


SPFDEVEL. JACK. TEST 


x 


SEQ 


COSTELLO 


191 


F 


80 


S 


MM 


SPFDEVEL. JACK. TEXT 


X 


TEXT 


COSTELLO 


191 


F 


80 


S 


MM 


SPFDEVEL. JAS.P LI 


* 


PLI 


STEPHENS 


191 


F 


80 


S 


M 


SPFDEVEL.KLEIN.PLI 


* 


PLI 


KLEIN 


191 


F 


80 


S 


H 


SPFDEVEL. MOSTON.PLI 


* 


PLI 


MOSTON 


191 


F 


80 


S 


MH 


SPFDEVEL. MOSTON. TEXT 


* 


TEXT 


MOSTON 


191 


F 


80 


S 


MH 


SPFDEVEL. M032779. MENUS 


MO 32 779 


MACLIB 


ORR 


191 


F 


60 


M 


MH 


SPFDEVEL. M033079. MENUS 


MO 330 79 


MACLIB 


ORR 


191 


F 


80 


M 


MH 


SPFDEVEL. M041 279. MENUS 


M041279 


MACLIB 


ORR 


191 


F 


80 


M 


MH 


SPFDEVEL.ORR.EXEC 


* 


EXEC 


ORR 


191 


V 


120 


S 


MH 


SPFDEVEL.ORR.MAC 


ORRMAC 


MACLIB 


ORR 


191 


F 


80 


M 


MH 


SPFDEVEL. P032779.PLI 


SPF0001M 


MACLIB 


PAQUETTE 


191 


F 


80 


M 


MH 


SPFDEVEL. T3GIM. SCRIPT 


X 


SCRIPT 


JOS LIN 


194 


V 


132 


S 


M 


SPFDEVEL. T3IGC. SCRIPT 


x 


SCRIPT1 


JOS LIN 


194 


V 


132 


S 


M 


SPFDEVEL. T3PLM. SCRIPT 


x 


SCRIPT2 


JOS LIN 


194 


V 


132 


S 


M 


SPFDEVEL. T3PRM. SCRIPT 


x 


SCRIPT3 


JOSLIN 


194 


V 


132 


S 


M 



Figure 5.7. SPF Project Uti lity - Sample Listing 
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RESET SPF STATISTICS UTILITY (OPTION 3.5) 



When this option is specified, a panel is displayed that allows 
the user to create, update, or delete SPF statistics and to reset 
sequence numbers (Figure 58). The reset utility handles only SPF 
libraries. Refer to the section entitled "SPF Library Statistics" 
for a discussion of the type of information maintained for each 
member of an SPF library. 

There are three valid options for this utility: 

R - Create/update statistics, conditionally reset sequence 

numbers 
N - Create/update statistics, no reset of sequence numbers 
D - Delete SPF statistics 



SELECT OPTION ===> R 



RESET SPF STATISTICS 



R - CREATE/UPDATE SPF STATISTICS, CONDITIONALLY RESET SEQUENCE NUMBERS 
N - CREATE/UPDATE SPF STATISTICS, NO RESET OF SEQUENCE NUMBERS 
D - DELETE SPF STATISTICS 

NEW VERSION NUMBER ===> 2 (REQUIRED FOR OPTION R) 

NEW CMS USER ID ===> XXXXXXX (IF USER ID IS TO BE CHANGED) 

SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY "=> XXX 
TYPE ===> COBOL 

MEMBER ===> * 



(BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 



UPDATE PASSWORD ===> 



Figure 58. Reset Utility Panel 



The "R" option is used to either create SPF statistics in a 
library that does not currently have them, or to update SPF sta- 
tistics in a library. The data is scanned to determine if valid, 
ascending sequence numbers are present in all records. If so, the 
data i s renumbered and the modification level flags (the last two 
digits of each sequence number) are set to zeros. If valid 
sequence numbers are not present, renumbering is not done. 

The "N" option is also used to create or update SPF statistics as 
in option "R"; however the data is not renumbered. This option 
should be used if the data already contains SPF statistics and the 
user wants to update the user id and/or version information with- 
out renumbering the data. 

The "D M option is used to delete SPF statistics. 
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The version number field is required for option W R", optional for 
option "N", and ignored for option "D". If option "N" is selected 
and a member without SPF statistics is selected, the statistics 
are created as if the version had been specified as "1". If a 
version number is specified, the statistics are created or reset 
as follows: 

Version number: set to the specified value 

Modification level: set to zero 

Creation date: set to current date 

Date/time last modified: set to current date and time 

Current number of lines: set to the current number of lines 

Initial number lines: set to the current number of lines 

Number of modified lines: set to zero 

The user id field is optional for options "R" or "N"; it is 
ignored for option "D". If a user id is specified, it will be 
placed in the user id field of the SPF statistics. If the user id 
is left blank and a member wi thout SPF statistics is selected, the 
user id field of the statistics will be set to the current user 
id. 

The rules for specifying member names are as follows: 

• Specifying a valid member name causes the statistics to be 
created or updated for a single member. 

• Leaving the member name blank causes a member listing to be 
displayed. 

• Specifying a member name of asterisk ('*) causes the statis- 
tics to be created or updated for all members in the library. 

If a member listing is requested, the user may select members to 
be reset by entering an "S" in front of one or more member names. 
The member list may be scrolled up and down via the Scroll PF keys 
or via the LOCATE command. The member list may be terminated by 
pressing the End PF key, which causes a return to the reset utili- 
ty panel . 
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SPOOL UTILITY (OPTION 3.6) 



When this option is selected, a panel is displayed that allows the 
user to specify a library or file and indicate an action to be 
performed (Figure 59). 

Possible actions are: 

PR - Print 

PH - Punch with header 

PJ - Punch job (no header) 

DD - Disk dump 

XM - Transmit 

Note ; The SPF list and log files may not be specified; they may 
only be printed upon SPF termination. 



V 





SELECT OPTION ===> PR 


PR - PRINT PJ - PUNCH JOB (NO HEADER) 


PH - PUNCH WITH HEADER DD - DISK DUMP 


XM - TRANSMIT SPF LIBRARY OR FILE 


SPF LIBRARY: 


PROJECT ===> 


LIBRARY ===> 


TYPE ===> 


MEMBER ===> (* FOR ALL MEMBERS) 


CMS FILE: 


FILE ID ===> MYPROG LISTING_ 


MEMBER ===> (* FOR ALL MACLIB/TXTLIB MEMBERS) 


IF NOT LINKED, SPECIFY: 


OWNER'S ID ===> DEVICE ADDR. ===> LINK ACCESS MODE ===> 


READ PASSWORD ===> 


SPOOL INFORMATION: 


USER/MACHINE ID ===> OTHER PARMS ===> NO (YES OR NO) 


NODE/LINK ID ===> 



Figure 59. Spool Utility - First Panel 



Option "PR" (print) is used to print a listing file. 

The following options may be used to send data to another CMS 
user: 



) 



• Option "DD" (disk dump) for any CMS file. 

• Option "PH" (punch with header) for any CMS file that has a 
record length of 80 or less. 

• Option "XM" (transmit) for any CMS file or an entire SPF 
library (including library statistics). 

Option "PJ" (punch job) is used to send a f i le to another machine 
for job execution (may be used for sending CMS jobs to a CMS batch 
machine, or JCL to a VS or DOS/VSE machine). 
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An asterisk (*) may be entered in the member name field to process 
all members of an SPF library, or a CMS MACLIB or TXTLIB. 

The spool utility panel also allows the user to specify: 

• User/machine id - if the data is to be spooled to the virtual 
reader of another user or machine. 

• Node/link id - if the other virtual machine i s at a remote 
location on the network. 

• Other parms (yes/no) - to allow specification of additional 
parameters and options. 

When the user enters the desired information, a second panel will 
be displayed if "other parms - yes" was specified on the first 
panel. Information entered on the second panel during previous 
uses of this utility is remembered and automatically redisplayed. 
This excludes "user/machine id" and "node/link id" which are sim- 
ply copied from the first panel, but may be modified on the second 
panel . 

For all options except "XM" (transmit), the following information 
may be entered on the second panel. See Figure 60. 

• Print command options - if option "PR" was specified. See 
description of PRINT command in VM/SP CMS Command and Macro 
Reference , SC19-6209. 

• Number of copies - if more than one copy is desired. 

• Spool class - for other than class A. 

• Bin number - for other than than the user's default destina- 
tion. 

• 'For' user - to spool the output to another user's virtual 
printer on the same VM system (ignored if either 
"user/machine id" or "node/link id" is specified). 

• 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in VM/SP CP Command 
Reference for General Users , SC19-6211. 

• User/machine id - to spool the output to the virtual reader of 
another user or machine. 

• Node/link id - if the desi nation is a remote node on the net- 
work (valid with either "user/machine id" or "tag text", but 
not both) . 

• Tag text - to specify control parameters for printing on a 
remote non-VM system. See description of TAG command in 
VM/370 RSCS Networking Program Reference and Operations 
Manual , SH24-5005. 

For option "XM" (transmit), the following information may be 
entered on the second panel . 

• Return acknowledgment (yes/no) - "yes" causes automatic gen- 
eration of an acknowledgment message from the receiving 
user/machine. (The default is "yes" if the second panel is 
not di splayed. ) 

• User/machine id - to spool the output to the virtual reader of 
another user or machine. (This parameter is required for 
option "XM".) 

• Node/link id - if the desination user/machine i s at a remote 
node on the network. 

If "other parms - no" was specified on the first panel, the second 
panel is not displayed and the remembered information is not used. 
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SPF generates the appropriate command (e.g., PRINT, PUNCH, DISK 
DUMP), depending on the option selected, to spool the data to the 
specified desination. The first panel is then redisplayed to 
allow specification of additional data to be spooled. When the 
End PF key is pressed from the first panel, the spool file is 
closed (releasing the data for output) and the user is returned to 
the next highei — level panel. 

Cauti on ; Erroneous results may occur if this utility is used in 
split screen mode while printer or punch output is also being 
generated from the other logical screen. Output from the two log- 
ical screens may be intermingled on the virtual printer or punch 
if the user jumps back and forth between the screens. 



SPOOL FILE: MYPROG LISTING 
SPECIFY PARAMETERS: 



dotmt rnMMAMn noTTnwc -!==■* rr 



SPOOL OPTIONS: 
NUMBER OF COPIES 
BIN NUMBER 
3800 KEYWORDS 



===> 1 SPOOL CLASS —=> A 

:==> 'FOR' USER ===> 

===> CHARS TN FLASH ABCD MODIFY X123 



FOR SPOOLING TO ANOTHER PERSON OR MACHINE: 
USER/MACHINE ID ===> 
NODE/LINK ID ===> 

TAG TEXT ===> 



Figure 60. Spool Utility - Second Panel 
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READER UTILITY (OPTION 3.7) 

The reader utility-allows the user to retrieve files from his vir- 
tual reader, including output (TEXT files, LISTING files, etc.) 
produced by the CMS batch machine as a result of SPF batch proc- 
, essi ng (option 5) . 

The options displayed by this utility are dependent upon the sta- 
tus and characteristics of the first active file on the user's 
virtual reader. 

For a TEXT file produced by an SPF batch compile or assembly 
(option 5) for which the source was from an SPF library, the 
opti ons are: 



D - Delete reader file 
R - Read file onto A-di sk 
I - Insert batch output TEXT 



in SPF library 



An example of this panel is shown in Figure 61. The default 
option in this case is "I" (pre-entered on the panel). If option 
"I" is used, the user must specify an update password if the SPF 
TEXT library (into which the file is to be inserted) i s on a pass- 
word protected minidisk. 

If the user selects option "R", the following additional informa- 
tion may be specified: 

• Replace like-named file (yes/no) - where "no" prevents a file 
with the same filename and filetype on the user's A-di sk from 
being overwritten. 



Rename to 
reader to 
A-disk. 



new file id - which allows the file in the virtual 
be renamed in the process of moving it to the user's 



_ READER UTILITY 

NEXT FILE ON YOUR READER IS: MEMBER1 TEXT 

SELECT OPTION ===> I 



D - DELETE READER FILE 
R - READ FILE ONTO A-DISK 
I - INSERT BATCH OUTPUT TEXT IN SPF 
UPDATE PASSWORD ===> 

FOR OPTION R: 

REPLACE LIKE-NAMED FILE ===> 
RENAME TO NEW FILE ID ===> 



LIBRARY: SPFDEMO.MOSTON.TEXT 



(YES OR NO) 
(OPTIONAL) 



Figure 61. Reader Utility Panel 
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When the user selects an option and presses the ENTER key, the 
first file on the user's virtual reader is processed. SPF then 
examines the next file on the reader and redisplays the reader 
utility panel with options that are appropriate for the file. 

'} All variations of the reader utility panel include the "D" (de- 

lete) and "R" (read) options. When the "R" option is selected, 
SPF issues a CMS command, such as READCARD or DISK LOAD, appropri- 
ate for the file being processed. 

The other panels displayed by this utility sre similar to the one 
shown in Figure 61, except as follows: 

1. If the first file on the reader is not a TEXT file for which 
the source was from an SPF library, the "I" option (and asso- 
ciated password field) will not be displayed. 

2. If the first file on the reader is a transmitted file (sent 
via the "XM" option of the spool utility), the following addi- 
tional option will be displayed: 

e _ ej-^ — i **■* coc i:u_-„.. 

The SPF library identification fields (project, library, and 
type) are prefilled with the library identification as it 
appears in the reader. The user may change this information to 
assign a new library identification. See Figure 62 top. 

If option "S" is selected and the SPF library does not cui — 
rently exist, a second panel is displayed to allow specifica- 
tion of SPF library attributes (Figure 62 bottom). 

If option "S" is selected and the library does exist, a con- 
firmation panel is displayed with a warning that incoming 
members will replace like-named members in the existing 
library. As directed in the confirmation panel, the user may 
then press ENTER to continue or press the End PF key to can- 
cel . 

s 

1/ 3. If the first file on the reader is an acknowledgment from a 

transmit, the following additional option will be displayed: 

L - Log message in MAIL LOG file 

This option causes the message to be added to the end of file 
'MAIL LOG A* on the user's A-disk. If such a file does not 
currently exist, it is created. 

4. If the reader is empty, or if the first file in the reader 
cannot be processed by this utility, one of the following mes- 
sages is displayed on the second line of the panel: 

NEXT FILE ON YOUR READER IS: READER IS EMPTY 
NEXT FILE ON YOUR READER IS: NOT CLASS A FILE 
NEXT FILE ON YOUR READER IS: FILE IN HOLD STATUS 

In these cases, the only option is to return to the previous 
panel by pressing either the ENTER key or the End PF key. For 
files which are not class A or which are in hold status, a CMS 
command may be entered (under SPF option 6) to change the 
class or status. This utility may then be reselected to con- 
tinue processing the virtual reader. 
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_ READER UTILITY - 

NEXT FILE ON YOUR READER IS: Z77EP0. DEMO. SCRIPT 

SELECT OPTION ===> S 

D - DELETE READER FILE 

S - STORE INTO SPF LIBRARY 

R - READ FILE TO A-DISK 

FOR OPTION R: 

SPECIFY CMS FILE ID ===> 
REPLACE LIKE-NAMED FILE ===> 

FOR OPTION S, SPECIFY SPF LIBRARY NAME: 
PROJECT ===> SPFDEVEL_ 
LIBRARY ===> DEMO 
TYPE ===> SCRIPT 

UPDATE PASSWORD ===> 

PRESS END KEY TO EXIT WITH NO ACTION. 



FROM: DPMG2 Z77EPO 



(A-DISK ONLY) 
(YES OR NO) 



RECEIVE AS SPF LIBRARY: SPFDEVEL. DEMO. SCRIPT 
RECFM: V LRECL: 120 



SPECIFY LIBRARY ATTRIBUTES: 
ORGANIZATION ===> S 
OWNER'S ID ===> 
DEVICE ADDR. ===> 
LINK ACCESS MODE ===> W_ 
CMS FILETYPE ===> 
CMS FILENAME ===> 



(S = SET OF FILES, M = MACLIB, T = TXTLIB) 

(BLANK FOR YOUR USERID) 

(BLANK FOR '191*) 

(SPECIFY N, W, OR MW FOR UPDATE ACCESS) 

(ORG S; BLANK FOR SPF-ASSIGNED FILETYPE) 

(ORG M OR T; BLANK FOR SPF-ASSIGNED FILENAME) 



Figure 62. Reader Utility - Receiving SPF Libraries 
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RETRIEVE UTILITY (OPTION 3.8) 



When this option is selected, a panel is displayed that allows the 
user to specify a tape unit and serial number to retrieve SPF 
libraries (via tape) from a TSO system (Figure 63). The tape 
drive should be attached to the user's machine and readied before 
this utility is used. 

This utility has the following options: 

1 - Retrieve all SPF libraries on the input tape 

2 - Retrieve selected SPF libraries from the input tape 

The tape must be a standard labeled tape created by the IEHMOVE 
utility. Any SPF/TSO library (partitioned data set with a 3-level 
name) with fixed or variable record format can be processed. SPF 
library statistics ar& also retrieved during the processing. 



Note ; This utility may not be used to place members 
SPF/CMS TEXT library with organization "T" (TXTLIB). 



into an 



When the end of tape is reached, or the End or Return PF key i s 
pressed, the tape is rewound but not unloaded. 



CMS RETRIEVE UTILITY 

SELECT OPTION ===> _ 

1 - RETRIEVE ALL SPF LIBRARIES ON THE INPUT TAPE 

2 - RETRIEVE SELECTED SPF LIBRARIES FROM THE INPUT TAPE 



TAPE SERIAL ===> 
TAPE UNIT ===> 



(MOUNT AND READY TAPE BEFORE PRESSING ENTER) 
(181, 182, 183, OR 184) 



IF OPTION '1' IS SELECTED: 

- THE LIBRARIES MUST HAVE BEEN SPECIFIED VIA OPTION 3.2 

- LIKE-NAMED MEMBERS ARE REPLACED, OTHER MEMBERS ARE ADDED 



Figure 63. Retri eve Uti li ty Panel 



Retrieve All Libraries 




been previously specified 

Project name, 

pe must exactly 

" ch no match i s 
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The record length of the receiving library must be equal to or 
greater than that of the tape library, and the record formats must 
agree. Blocked record formats are accepted. 

The receiving library may be empty, or it may already contain mem- 
bers. As members are copied from the tape into the specified 
library, new members are added and like-named members are 
replaced. 



Retrieve Selected Libraries 

For option "2" the identification of each SPF library encountered 
on tape may be reviewed at the terminal as the tape is read. The 
user may then choose to retrieve the library, skip to the next 
library on the tape, or search the tape for a specified library. 
Optionally, a library may be renamed as it is retrieved. 

If a library has not been previously specified to SPF/CMS, its 
characteristics may be specified during the retrieval process. 
For libraries which have already been specified, the rules for 
record format and length are the same as for option "1", but the 
replacement of like-named members is under user control. 

Either of two secondary panels is displayed for each library read 
from tape (see Figure 64). The first panel shown in the figure is 
displayed if the library is already specified to SPF/CMS. The user 
then has the following options: 



M 



Merge members from tape with the specified SPF/CMS library. 
For this option, the user must specify the yes/no option for 
replacement of like-named members. (The library may be spec- 
ified and empty.) 

I - Identify a new library name (rename option). For this option, 
the desired library identification (project name, library 
name, and type) must be entered. If the designated library 
already exists, the first panel shown in Figure 64 is 
redisplayed. Normally, the user would then select option "M". 
If the designated library does not exist, the second panel 
shown in Figure 64 is displayed. Normally, the user would 
then select option "C" and enter the library attributes (see 
description of option "C" below). 

S - Skip to the next library on the tape. A secondary panel is 
displayed for the next library, and the user may choose the 
desi red option. 

P - Position tape to a specified library (and skip the current 
library). For this option, the user must supply the project 
name, library name, and type for a library on the tape. If 
the library is found a secondary panel is displayed, and the 
user may choose the desired option. If the end of tape is 
encountered before the library is found, the tape is rewound 
and the first retrieve panel is redisplayed. If the tape is 
positioned beyond the specified library, it is backspaced to 
that library. 

If the library read from tape has not been specified to SPF/CMS, 
the second panel shown in Figure 64 is displayed. The first 
option on this panel is: 

C - Create new SPF library. For this option, the library 
attributes must be specified on the lower part of the panel. 
This is the same information which may be specified under the 
file utility* option 3.2 ("specify"), except that the record 
format and length are are taken from the tape library. 

Other options on this panel are the same as those described above. 
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RETRIEVE TAPE FILE: 
SELECT OPTION ===> 



SPFDEMO.MYLIB.PLI 



M - MERGE WITH EXISTING LIBRARY NAMED: SPFDEMO.MYLIB.PLI 

I - IDENTIFY ALTERNATE LIBRARY NAME BELOW 

S - SKIP TO THE NEXT LIBRARY ON TAPE 

P - POSITION THE TAPE TO THE SPF LIBRARY NAMED BELOW 



SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> MYLIB 
TYPE ===> PLI 



(TAPE LIBRARY RECFM: F LRECL: 80 



UPDATE PASSWORD ===> 



REPLACE LIKE-NAMED MEMBERS ===> NO 



(YES OR NO) 



RETRIEVE TAPE FILE: 
SELECT OPTION ===> 



SPFDEMO. XXX. COBOL 



C - CREATE NEW SPF LIBRARY NAMED: SPFDEMO. XXX. COBOL 

I - IDENTIFY ALTERNATE LIBRARY NAME BELOW 

S - SKIP TO THE NEXT LIBRARY ON TAPE 

P - POSITION THE TAPE TO THE SPF LIBRARY NAMED BELOW 



SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> XXX 
TYPE ===> COBOL 



(EXISTING LIBRARY RECFM: F LRECL: 80 ) 



UPDATE PASSWORD ===> 



SPECIFY LIBRARY ATTRIBUTES: 

ORGANIZATION ===> S 

OWNER'S ID ===> KLEIN 

DEVICE ADDR. ===> 

LINK ACCESS MODE ===> W 

CMS FILETYPE ===> COBOL 

CMS MACLIB NAME ===> 



(S=SET OF FILES, M=MACLIB) 

(BLANK FOR YOUR USERID ) 

(BLANK FOR '191') 

(SPECIFY 'W', 'M', OR 'MW FOR UPDATE ACCESS) 

(IF ORG 'S' - BLANK FOR SPF ASSIGNED FILETYPE) 

(IF ORG *M' - BLANK FOR SPF ASSIGNED FILENAME) 



Figure 64. Retrieve Utility - Secondary Panels 
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SCRIPT/VS UTILITY (OPTION 3.9) 



When this option is selected, a sequence of panels is displayed to 
allow formatting* displaying, and printing of text maintained in 
SPF libraries or sequential CMS files. Use of this utility 
requires the installation of the Document Composition Facility 
(SCRIPT/VS), program product 5748-XX9, with the Foreground Envi- 
ronment Feature. 

This utility has the following options: 



1 - Draft document options 

2 - Final document options 

For the draft document options, it is assumed that the primary 
interest of the user is to assure that the content, syntax, and 
spelling within the document are correct. The final document 
options provide additional flexibility and control for the user 
interested in specific document formats. 

The first panel displayed by the SCRIPT/VS utility is used to 
select the draft or final options, and to specify the library or 
file to be formatted (Figure 65). For SPF libraries, a member list 
will be displayed if a member name is not specified. A concat- 
enated sequence of SPF libraries may be specified to allow inclu- 
sion of imbedded or appended members from more than one library. 

Any SPF libraries to be processed by this utility must have an 
organisation of "S" (set of sequential files). They need not have 



an SPF type qualifier of 
files need not have a CMS 
file id is specified (on 
have a filetype of SCRIPT, 



SCRIPT, and the corresponding set of 
filetype of SCRIPT. If, however, a CMS 
the second part of the panel) it must 
and any imbedded or appended files must 

also have a filetype of SCRIPT unless they are explicitly defined 

via a SCRIPT ".dd" control word. 



SCRIPT/VS SELECTION MENU 



SELECT OPTION ===> _ 

1 - DRAFT DOCUMENT OPTIONS 



2 - FINAL DOCUMENT OPTIONS 



SPF LIBRARY TO BE FORMATTED: 
PROJECT ===> SPFDEMO 

LIBRARY ===> MYLIB ===> DEPTLIB ===> ===> 

TYPE ===> SCRIPT 

MEMBER ===> (BLANK FOR MEMBER SELECTION LIST) 



CMS FILE TO BE FORMATTED: 
FILE ID ===> 
IF NOT LINKED SPECIFY: 
OWNER'S ID ===> 



OUTPUT LISTING FILE: 
FILE ID ===> 

READ PASSWORD ===> 



DEVICE ADDR. ===> ACCESS MODE ===> 

(DEFAULT IS 'MEMBER/FILENAME LISTING A') 



Figure 65. SCRIPT/VS Utility - First Panel 
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Processing Sequence 



The processing sequence for the SCRIPT/VS utility is as follows; 

1. The user enters the appropriate information on the first 
panel, and presses the ENTER key. 

2. A secondary panel is displayed for either the "draft" or 
"final" document options, depending on which option was spec- 
ified on the first panel. The user enters the appropriate 
information on the secondary panel (see below) and presses 
the ENTER key. 

3. The SCRIPT/VS formatter is invoked. If the "quiet" option has 
not been specified, the screen is blanked and a one-line mes- 
sage is displayed, indicating that SCRIPT/VS processing has 
started. When processing is complete, a "MORE..." message is 
displayed in the lower right-hand corner of the screen. The 
user then presses PA2. 

4 . The formatted output is displayed in browse mode. The output 
may be scrolled using the Scroll PF keys. All browse commands 
may be entered'. When the user has finished browsing the out- 
put, he presses the End PF key. 

5. The SCRIPT/VS print panel is then displayed to allow the for- 
matted output to be printed, kept, or deleted. The user 
enters the appropriate information on this panel (see below) 
and presses the ENTER key. 

6. The specified action (print, keep, or delete) is taken and the 
first SCRIPT/VS panel is redisplayed. The user may then foi — 
mat additional documents, or press the End PF key to return to 
the primary option menu. 

Note : If SCRIPT/VS terminates abnormally, an ABEND message is 
displayed in the upper right-hand corner of the screen. Browse is 
not entered. The listing file is retained, but the print option 
panel is not displayed. 



Draft Document Options 



When option 1 is selected on the first SCRIPT/VS panel, a second- 
ary panel is displayed to allow the user to specify the draft doc- 
ument options (Figure 66). All the parameters on this panel are 
optional. 

For automatic spelling verification, "yes" is entered in the 
spelling check field. Spelling verification must also be enabled 
within the document. (See the ".sv" command in the SCRIPT/VS 
User 1 s Guide. ) 

For all upper case printing, "yes" is entered in the upper case 
only field. 

For line numbers to be printed in the output document, "yes" is 
entered in the line number field. Line numbers can be useful for 
correcting errors and mis-spelled words, which SCRIPT/VS identi- 
fies by line number. 

Use of the "other SCRIPT parms" field allows input of any 
SCRIPT/VS parameters not on the panel. The NOPROF option must not 
be specified if the source is from an SPF library. 

If a SCRIPT/VS document profile i s to be used, the user must enter 
the name of the CMS file that contains the profile in the "pro- 
file" field. A file id of PROFILE SCRIPT should be entered for 
the default profile. 
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To incorporate one or more user GML libraries, the user must enter 
the filename(s) in the "symbol/macro lib" field. These files must 
be MACLIBs. If no files are specified, the default GML library, 
if one is defined, is used. 



_ SCRIPTVVS DRAFT DOCUMENT OPTIONS 

FILE NAME: SPFDEMO.MYLIB.SCRIPT(DOCXYZ) 

SCRIPT/VS DRAFT OPTIONS: 

SPELLING CHECK ===> NO (YES OR NO) 

UPPER CASE ONLY ===> YES (YES OR NO) 

LINE NUMBER ===> YES (YES OR NO) 



OTHER SCRIPT PARMS ===> 

PROFILE FILE ID ===> 

SYMBOL/MACRO "LIB" FILE NAMES: 
===> GML 



Figure 66. SCRIPT/VS Draft Document Options 



Final Document Options 



When option 2 is selected on the first SCRIPT/VS panel, a second- 
ary panel is displayed to allow the user to specify the final doc- 
ument options (Figure 67). All the parameters on this panel are 
optional. However, if a device type is entered, the lines per 
inch and form definition fields must be correctly filled in. 

For automatic spelling verification, "yes" is entered in the 
spelling check field. Spelling verification must also be enabled 
within the document. (See the ".sv" command in the SCRIPT/VS 
User's Guide. ) 

For all upper case printing, "yes" is entered in the upper case 
only f i eld. 

The next four fields on the panel are used to describe the output 
device and the physical characteristics of the printed page. The 
type of printer on which the output will be printed (and for which 
SCRIPT/VS will format the document) is specified in the "device 
type" field. If the document is to be printed on a device other 
than an IBM 1403 or 3800, this field should be left blank, and the 
printer should be specified in the "other SCRIPT parms" field (see 
below). 

The "lines/ inch", "form width" and "form length" fields are used 
to describe how the document should fit on the printed page. 
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The "3800 chars parm" field is used to specify the type font(s) if 
the document is being formatted for an IBM 3800 printer. The user 
may enter one or two SCRIPT/VS fonts or up to four 3800 character 
arrangement tables, separated by blanks. These same parameters 
must be specified on the SCRIPT/VS print panel (see below) with 
multiple CHARS parameters and an 0PTCD=J parameter. 

The user may specify the page margin to be used in binding the 
document by entering the size of the margin in the "binding" 
fields. A different margin can be specified for even and odd num- 
bered pages. For more information, see "BIND" in Document 
Composition Facility User's Guide , SH20-9161. 

Use of the "other SCRIPT parms" field allows input of any 
SCRIPT/VS parameters not on the panel. The NOPROF option must not 
be specified if the source is from an SPF library. 

If the "other SCRIPT parms" field is used to specify a device oth- 
er than the 1403 or 3800, the device must have been previously 
added to the SCRIPT/VS device characteristics table. A device may 
be selected from this table by leaving the "device type" field of 
the menu blank and specifying the SCRIPT/VS device parameter in 
the "other SCRIPT parms" field. 

If a SCRIPT/VS document profile i s to be used, the user must enter 
the name of the CMS file that contains the profile in the "pro- 
file" field. A file id of PROFILE SCRIPT should be entered for 
the default profile. 

To incorporate one or more user GML libraries, the user must enter 
the filename(s) in the "symbol/macro lib" field. These files must 
be MACLIBs. If no files are specified, the default GML library, 
if one is defined, is used. 



SCRIPT/VS FINAL DOCUMENT OPTIONS 

FILE NAME: SPFDEMO.MYLIB.SCRIPT(DOCXYZ) 



SCRIPT/VS FINAL OPTIONS: 

SPELLING CHECK ===> NO 
UPPER CASE ONLY ===> NO 



DEVICE TYPE 




==r> 


1403 


LINES/INCH 




=r=> 


6 


PAGE WIDTH 




===> 


8.5 


PAGE LENGTH 




===> 


11 


3800 "CHARS" 


PARM 


===> 




BINDING: ODD 


PAGE 


===> 




EVEN 


PAGE 


===> 





(YES OR NO) 
(YES OR NO) 
(1403 OR 3800) 
(6, 8, OR 12) 
(8.5, 11, OR 13.5) 
(8.5 OR 11) 



(SPECIFY MARGIN) 
(SPECIFY MARGIN) 



OTHER SCRIPT PARMS ===> 

PROFILE FILE ID ===> 

SYMBOL/MACRO "LIB" FILE NAMES: 
===> GML 



Figure 67. SCRIPT/VS Final Document Options 
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SCRlPT/VS Print Options 



When the user has finished browsing the formatted document, 
pressing the End PF key will cause a panel to be displayed to 
allow the output to be printed, kept, or deleted (Figure 68). On 
this panel* the "file id" field shows the id of the output listing 
file that contains the formatted text. 

If option "P" (print file) is selected, the following spool param- 
eters may be specified: 

• Number of copies - if more than one copy is desired. 

• Spool class - for other than class A. 

• 'For' user - to spool the output to another user's virtual 
printer on the same VM system (ignored if either 
"user/machine id" or "node/link id" is specified). 

• 3800 keywords - if output is directed to an IBM 3800 printer 
which is attached to the CMS system as a virtual spooling 
device. See description of SPOOL command in VM/SP CP Command 
Reference for General Users , SC19-6211. 

• User/machine id - to spool the output to the virtual reader of 
another user or machine. 

• Node/link id - if the desination is a remote node on the net- 
work (valid with either "user/machine id" or "tag text", but 
not both) . 

• Tag text - to specify control parameters for printing on a 
remote non-VM system. See description of TAG command in 
VM/370 RSCS Networking Program Reference and Operations 
Manual, SH24-50Q5. 



SELECT OPTION ===> P 



SCRIPT/VS PRINT MENU 



P - PRINT FILE (AND DELETE) 
K - KEEP FILE - DO NOT PRINT 
D - DELETE (ERASE) FILE - DO NOT PRINT 
BLANK AND END KEY DELETES FILE WITHOUT PRINTING 

FILE ID; DOCXYZ LISTING Al 



SPOOL OPTIONS: 

NUMBER OF COPIES ===> 1 SPOOL CLASS 

3800 KEYWORDS ===> CHARS TN_ 

FOR SPOOLING TO ANOTHER PERSON OR MACHINE: 
USER/MACHINE ID ===> 
NODE/LINK ID ="> 

TAG TEXT ===> 



===> A 



•FOR" USER ===> 



Figure 68. SCRIPT/VS Print Panel 



128 SPF-VM Program Reference 



FOREGROUND (OPTION 4) 



The foreground option provides an interface with standard lan- 
guage processors for foreground compilation and assembly of pro- 
grams stored in SPF libraries or CMS files. It also provides an 
interface to the FORTRAN and COBOL interactive debug facilities* 
and to the CMS LOAD command. 

The foreground selection menu is shown in Figure 69. 



SELECT OPTION ===> 



FOREGROUND SELECTION MENU 



1 - SYSTEM ASSEMBLER 

2 - QS/VS CCBOL COMPILER 

3 - FORTRAN IV (Gl) COMPILER 

4 - PL/I CHECKOUT COMPILER 



5 - PL/I OPTIMIZING COMPILER 
A - LOAD 

7 - COBOL INTERACTIVE DEBUG 

8 - FORTRAN INTERACTIVE DEBUG 

9 - PASCAL/VS COMPILER 



Figure 69. Foreground Selection Menu 



When a language processor has been selected, an entry panel is 
displayed to allow the user to specify SPF library information or 
CMS filename, and processor options. Figure 70 shows an example 
for Assembler. The project name, first library name, type qual- 
ifier, and member name must be specified to assemble a program 
whose source is in an SPF library. The filename must be specified 
to assemble a CMS file with a filetype of ASSEMBLE. (If the CMS 
filename is entered, it overrides any SPF library specification.) 
The other parameters are optional. 



) 
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FOREGROUND ASSEMBLY 

ENTER/VERIFY PARAMETERS BELOW: 



SPF LIBRARY: 

PROJECT ~=> SPFDEMO 
LIBRARY ===> XXX 
TYPE ===> ASM 
MEMBER ===> TOP_ 

CMS FILE: 

FILENAME ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID -"> 

READ PASSWORD ===> 



===> TEST 



===> MASTER 



DEVICE ADDR. ===> 
UPDATE PASSWORD ===> 



LINK ACCESS MODE -"> 



ASSEMBLER OPTIONS: 

===> LIST NODECK OBJECT 

ADDITIONAL CONCATENATED MAC LIBS: 

===> CMSLIB ===> OSMACRO 



Figure 70. Foreground - Assembler Example 



Once the entry panel has been filled in and the ENTER key has been 
pressed, the screen is cleared and the appropriate language 
processor is invoked. The GLOBAL command and the command that 
invokes the language processor is displayed along with certain 
other output of the language processor (depending on the options 
chosen) , such as error messages, prompts, and return codes. Any 
communication with the language processor is in line I/O mode. 

Upon completion of the foreground processing, a "MORE..." message 
will be displayed in the lower right-hand corner of the screen. 
The user may then press the PA2 key to return to the processor 
entry panel . " 

When the entry panel is redisplayed, a message indicating com- 
pletion of the process is displayed in the upper right-hand corner 
of the screen. The user may then enter other parameters and invoke 
the processor again or press the End PF key to return to the pre- 
vi ous menu. 



ASSEMBLER/COMPILER PROCESSING 



The Assembler entry panel shown in Figure 70 is typical of the 
language processor panels. In the figure, a library concat- 
enation sequence of three data sets has been specified. The con- 
catenation order is: 

SPFDEMO. XXX. ASM 
SPFDEMO. TEST. ASM 
SPFDEMO. MASTER. ASM 

Note : The SPF type qualifier for an assembler source library need 
not be ASSEMBLE, as illustrated in the example. 
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I 



Before invoking the foreground processor* SPF scans the concat- 
enated sequence of libraries to find the member to be assembled or 
compiled (member TOP in this example). A CMS file with a filetype 
acceptable to the language processor (ASSEMBLE in this example) 
is created on the user's A-disk by extracting the member from the 
first library in the sequence in which it occurs. 

For any library in the sequence that is a collection of sequential 
files, a MACLIB is created on the user's A-disk to enable the use 
of COPY or INCLUDE statements. (For performance reasons, it is 
recommended that high-level libraries be specified as MACLIBs.) 

Any temporary files created by SPF will be erased at the com- 
pletion of the foreground process. 

For this example, if SPFDEMO.XXX. ASM is a colletion of sequential 
files and the higher-level libraries are already MACLIBs, the 
GLOBAL command preceding the ASSEMBLE command might look like: 

GLOBAL MACLIB SPF00511 TEST MASTER CMSLIB OSMACRO 

where SPF00511 is the SPF generated filename for the MACLIB con- 
taining all the members of SPFDEMO.XXX. ASM. 

Note the following points: 

1. The concatenation sequence serves two purposes: It is used by 
SPF to locate the primary member to be assembled, and it 
allows inclusion of subsidiary members referenced by COPY 
statements in the assembler source. 

2. Other MACLIBs can be appended to the GLOBAL statement, fol- 
lowing the SPF libraries, by specifying them in the desired 
order in the "additional concatenated MACLIBs" fields. 

3. If the source is from an SPF library, the TEXT file is placed 
in an SPF library with a three-level name composed of the 
project name, the first library name, and a type qualifier of 
TEXT. The SPF member name for the TEXT file is the same as 
the source member. The LISTING file is placed on the user's 
A-disk. Its filename is the same as the source member name. 

4. If the source is specified as a CMS file (rather than an SPF 
library), the filetype must be whatever is acceptable to the 
language processor (ASSEMBLE in this example). The resulting 
TEXT and LISTING files are placed on the user's A-disk. 

5. In specifying a CMS file that would require a LINK and ACCESS, 
the user must provide the necessary LINK information: The 
user id of the owner, the virtual device address of the mini- 
disk on which the source resides, and the desired link access 
mode (e.g, RR) . 

6. The language processor options are passed to the processor 
exactly as specified by the user. Up to 16 tokens may be 
specified as processor options. Only those options specified 
on the panel are passed to the language processor; SPF does 
not automatically generate any options. 

The entry panels for the various compilers are similar to the one 
for Assembler. The meanings of the options differ among the 
several language processors. Cheek the user's guide for the spe- 
cific language for an explanation of the processor options. 

Compiler output is handled differently in the following cases: 

• When the TEST option is specified for the FORTRAN compiler, a 
special TEXT file is produced for later use by the FORTRAN 
interactive debug facility. The file is not placed in an SPF 
library. Rather, it is left on the user's A-disk, as is the 
generated FORTRAN file. 

• When the TEST option is specified for the COBOL compiler, a 
SYSUT5 file is produced for later use by the COBOL interactive 
debug faci li ty. The file is placed on the user's A-disk. 
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When the OBJECT option is specified for the PL/I Checkout com- 
piler, a special TEXT file (a "link edit stub") and an ITXTLIB 
file ( i nterpretable text) are produced for later use with the 
PLICR command. Both files are placed on the user's A-disk. 



The entry panels for the interactive debug 
somewhat from the other foreground panels: 



facilities differ 



The COBOL interactive debug panel allows specification of up 
to four additional program ids (which must match the external 
filenames), and PRINT and SOURCE options which determine what 
FILEDEFs &rs generated by SPF. Also allowed are 15 tokens of 
execution parameters that are stacked for use by the process- 
or, and the specification of up to four additional TXTLIBs. 

The FORTRAN interactive debug panel allows variations of the 
DISK or PRINT options, the specification of up to four addi- 
tional filenames, and the specification of up to four TXTLIBs 
to be included in the GLOBAL TXTLIB command. 



LOAD PROCESSING 



This foreground option (option 4.6) provides an interface to the 
LOAD command (Figure 71). The entry panel allows a simple LOAD 
and GENMOD command to be issued with the specified options, or a 
user-specified EXEC to be issued for more complex load functions 
with multiple filenames, INCLUDES, etc. 



FOREGROUND LOAD 



ENTER/VERIFY PARAMETERS BELOW: 

SPF LIBRARY: 

PROJECT ===> SPFDEMO 

LIBRARY ===> XXX ===> TEST 

TYPE ===> TEXT 

MEMBER ===> TOP 



CMS FILE: 

FILENAME ===> 

IF NOT LINKED, SPECIFY: 

OWNER'S ID ===> 

READ PASSWORD ===> 

USER EXEC ===> 
OPTIONS: 

LOAD ===> CLEAR MAP 

GENMOD ===> MAP 



===> MASTER 



DEVICE ADDR. —=> 



LINK ACCESS MODE ===> 



(USER'S EXEC TO BE RUN INSTEAD OF LOAD/GENMOD) 



ADDITIONAL CONCATENATED TXTLIBS: 



Figure 71. Foreground - LOAD Panel 
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BATCH (OPTION 5) 



The batch option provides an interface with standard language 
processors for compilation and assembly in the CMS batch machine 
of programs stored in SPF libraries or CMS files. It also pro- 
vides an interface for batch execution of the CMS LOAD command. 

The batch selection menu is shown in Figure 72. It allows the 
user to enter job statement parameters as well as select a lan- 
guage processor. 

As with other secondary menus, it is possible to bypass the batch 
selection menu by entering two numbers* separated by a decimal 
point, on the primary option menu. For example, "5.2" to select a 
batch COBOL compile. Note, however, that use of this procedure 
does not allow verification or changes to the job statement param- 
eters, nor does it allow the generation of multiple compilations 
(multiple job steps) within the same job. 



SELECT OPTION ===> 



BATCH SELECTION MENU 



1 - SYSTEM ASSEMBLER 

2 - OS/VS COBOL COMPILER 

3 - FORTRAN IV (Gl) COMPILER 



4 - PL/I CHECKOUT COMPILER 

5 - PL/I OPTIMIZING COMPILER 

6 - LOAD 

9 - PASCAL/VS COMPILER 



BATCH JOB INFORMATION: (ENTER OR VERIFY BEFORE PROCEEDING) 

(YOUR CMS USER ID AUTOMATICALLY BECOMES YOUR BATCH JOB USER ID.) 



BATCH MACHINE ID 



===> CMSB 



JOB STATEMENT INFORMATION: 

ACCOUNT NUMBER ===> U101 
JOS NAME ===> LEM 



> 



Figure 72. Batch Selection Menu 



When job information has been entered and a language processor 
selected, an entry panel is displayed to allow the user to specify 
SPF library information or CMS filename, and processor options. 
Figure 73 shows an example for the PL/I opt imi zing compi ler. The 
project name, first library name, type qualifier, and member name 
must be specified to compile a program whose source is in an SPF 
library. The filename must be specified to compile a CMS file 
with a filetype of PLI or PLIOPT. (If the CMS filename is entered, 
it overrides any SPF library specification.) The other parame- 
ters are optional. 
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BATCH PLI OPTIMIZING COMPILE 

ENTER/VERIFY PARAMETERS BELOW: 



SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> LARRY 
TYPE ===> PLI 
MEMBER ===> TOPSEG 



===> V3TEST 



===> MASTER 



CMS FILE: 

FILENAME ===> 

IF NOT LINKED IN YOUR LOGON DIRECTORY, SPECIFY: 

OWNER'S ID ===> DEVICE ADDR. *==>' 



LINK ACCESS MODE ===> 



READ PASSWORD ===> 



UPDATE PASSWORD ===> 



COMPILER OPTIONS: 

===> MACRO OBJECT SOURCE XREF 

ADDITIONAL CONCATENATED MACLIBS: 



Figure 73. Batch - PL/I Opt imi z\ ng Compi ler Example 



When the user has filled in the panel and pressed the ENTER key, 
SPF generates the appropriate commands to be run in the batch 
machine. After SPF has generated the commands* it returns to the 
batch selection menu (unless that menu was bypassed by entering 
two numbers on the primary menu) > with a message "job step genei — 
ated" displayed in the short message area (line 1). If the batch 
selection menu was bypassed, SPF submits the generated commands 
and returns to the primary option menu. In either case, the user 
may exit from the processor entry panel without generating any 
commands by pressing the End PF key rather than the ENTER key. 

When the batch selection menu is redisplayed, the job statement 
parameters are shown for information only — they are no longer 
intensified and may not be overtyped. At this point, the user may 
select another processor to cause more commands (another job 
step) to be generated, enter CANCEL to return to the primary 
option menu without submitting the job, or press the End PF key 
(or Return PF key) to cause the generated commands to be submitted 
to the batch machine for execution. 

If the job is submitted, a confirmation message is displayed, 
accompanied by a "HOLDING" message in the lower right-hand corner 
of the screen. When the user presses the PA2 key, SPF returns to 
the the primary option menu. 

The batch machine sends messages to the user indicating the 
progress of the job. When the job has completed, the SPF reader 
utiltiy (option 3.7) may be used to retrieve TEXT and LISTING 
files produced by the batch job. 

Cauti on : Erroneous results may occur if the batch option is used 
in split screen mode while punch output is also being generated 
from the other logical screen. Output from the two logical 
screens may be intermingled on the virtual punch i f the user jumps 
back and forth between the screens. 
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ASSEMBLER/COMPILER PROCESSING 

The entry panel shown in Figure 73 is typical of the batch 
language processor panels. In the figure, a library concat- 
enation sequence of three libraries has been specified. The con- 
catenation order is: 

SPFDEMO. LARRY. PLI 
SPFDEM0.V3TEST.PLI 
SPFDEMO. MASTER. PLI 

Before invoking the batch process, SPF will scan the concatenated 
sequence of libraries to find the member to be assembled or com- 
piled (member TOPSEG in this example). A CMS file with a f i letype 
acceptable to the language processor (PLI in this example) will be 
created on the user's A-di sk by extracting the member from the 
first library in the sequence in which it occurs. 

For any library in the sequence that is a collection of sequential 
files, a MACLIB will be created on the batch machine's A-di sk to 
enable the use of COPY or INCLUDE statements. (For performance 
reasons, it is recommended that high-level libraries be specified 
as MACLIBs.) 

Any temporary files created by SPF will be erased at the com- 
pletion of the batch process. 

Note the following points: 

1. The concatenation sequence serves two purposes: It is used by 
SPF to locate the primary member to be compiled, and it allows 
inclusion of subsidiary members referenced by INCLUDE state- 
ments in the PL/I source. 

2. Other MACLIBs can be appended to the GLOBAL statement, fol- 
lowing the SPF libraries, by specifying them in the desired 
order in the "additional concatenated MACLIBs" fields. 

3. The read password specified on the data entry panel must pro- 
vide access to the user's A-di sk as well as the source data. 
A minidisk with a. read password of ALL will be accessible 
regardless of the password specified on the panel. 

4. The TEXT and LISTING files produced by the batch process are 
placed in the user 'svi rtual - reader using the DISK DUMP com- 
mand. The SPF reader utility (option 3.7) may be used to 
retrieve these files following completion of the job. 

5. If the source is specified as a CMS file (rather than an SPF 
library), the fi letype must be whatever is acceptable to the 
language processor (PLI or PLIOPT in this example). 

6. In specifying a CMS file that would require a LINK and ACCESS 
(i.e., if the file is on a minidisk not defined by an MDISK or 
LINK statement in the user's own LOGON directory), the user 
must provide the necessary LINK information: The user's id 
whose directory does contain that information, the virtual 
device address of the minidisk on which the source resides, 
and the desired link access mode (e.g, RR). 

7. The language processor options are passed to the processor 
exactly as specified by the user. Up to 15 tokens may be 
specified as processor options. Only those options specified 
on the panel are passed to the language processor; SPF does 
not automatically generate any options. 

The entry panels for Assembler and other compilers are similar to 
the one for the PL/I Optimizer. The meanings of the options dif- 
fer among the several language processors. Check the user's guide 
for the specific language for an explanation of the processor 
options. 
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Compiler output is handled differently in the following cases: 

• When the TEST option is specified for the FORTRAN compiler, a 
special TEXT file is produced for later use by the FORTRAN 
i nteracti ve debug facility. The file is punched to the user's 
virtual reader, as i s the generated FORTRAN file. 

• When the TEST option is specified for the COBOL compiler, a 
SYSUT5 file is produced for later use by the COBOL interactive 
debug facility. The file is punched to the user's virtual 
reader. 

• When the OBJECT option is specified for the PL/I Checkout com- 
piler, a special TEXT file (a "link edit stub") and an ITXTLIB 
file ( i nterpretable text) are produced for later use with the 
PLICR command. Both files are punched to the user's virtual 
reader. 



LOAD PROCESSING 



This batch option (option 5.6) provides an interface to the LOAD 
command (Figure 74). The entry panel allows a simple LOAD and 
GENMOD command to be issued with the specified options, or a 
usei — specified EXEC to be issued for more complex load functions 
with multiple filenames, INCLUDES, etc. 



ENTER/VERIFY PARAMETERS BELOW: 



SPF LIBRARY: 

PROJECT ===> SPFDEMO 
LIBRARY ===> XXX 
TYPE ===> TEXT 
MEMBER ===> TOP_ 



BATCH LOAD 



===>' TEST 



===> MASTER 



CMS FILE: 

FILENAME ===> 

IF NOT LINKED IN YOUR LOGON DIRECTORY, SPECIFY: 

OWNER'S ID ===> DEVICE ADDR. ===> 



LINK ACCESS MODE ===> 



READ PASSWORD ===> 

USER EXEC ===■> 
OPTIONS: 

LOAD ===> CLEAR MAP 

GENMOD ===> MAP 



ADDITIONAL CONCATENATED TXTLIBS: 



(USER'S EXEC TO BE RUN INSTEAD OF LOAD/GENMOD) 



Figure 74. Batch - LOAD Panel 
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COMMAND (OPTION 6) 



The command option allows direct entry of a CMS command, CP com- 
mand, EXEC, or entry to CMS subset under SPF. When this option is 
selected, the CMS command panel is displayed (Figure 75). 



ENTER COMMAND BELOW: 



COMMAND AND EXEC PROCESSING 



ANY ONE OF THE FOLLOWING MAY BE ENTERED: 

- A CMS COMMAND 

- A CP COMMAND 

- AN EXEC SPECIFICATION 

- CMS (TO ENTER CMS SUBSET MODE, USE RETURN COMMAND TO 

RETURN FROM SUBSET TO SPF) 



Figure 75. CMS Command Panel 



The command or EXEC is entered to the right of the arrow, using 
standard CMS syntax. It may be continued on the next line, if 
necessary. Entering "CMS" causes entry to the CMS subset. In sub- 
set mode, more than one command may be entered at a time, and the 
PF and PA keys revert to their CMS definitions. The RETURN com- 
mand is used to exit subset mode. 

When the ENTER key is pressed, the command and any resulting out- 
put &re displayed on the screen as in a normal CMS environment. 
(The return code presentation may appear slightly different.) 
Following the last line displayed by the command, a "MORE..." mes- 
sage is displayed in the lower right-hand corner of the screen. 
The user should then press PA2. 

When the PA2 key is pressed, the panel i s redi splayed. The command 
which was just executed is pre-entered to the right of the arrow. 
The user may then enter another command, or press the End PF key 
to return to the primary option menu. 



Command (Option 6) 
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Option 6 cannot be used to: 

• Enter SPF recursively 

• Log off 

• Issue commands of a privi leged class beyond the user's class 

• Issue immediate commands (HX, HB, HO, etc.) 

• Issue commands that require the VM Communication Facility 
(VMCF). 

Results in all these cases are unpredictable. 

Caution : When a CMS command or EXEC is executing under option 6, 
do not attempt to enter an HX (halt execution) command. This will 
halt all commands or programs* including SPF, bypassing the 
normal SPF termination procedure. If this is done* a re-IPL of 
CMS will be required. 
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SUPPORT (OPTION 7) 



The support option provides test aids and conversion utilities 
for the development of applications to be run under the SPF dialog 
manager. The dialog manager is described in a separate document, 
SPF Dialog Management Services . 

The support selection menu is shown in Figure 76. 



SELECT OPTION ===> 



SUPPORT SELECTION MENU 



1 TEST PANEL - DISPLAY PANEL AS USER WOULD SEE IT 

2 TEST FUNCTION - INVOKE DIALOG FUNCTION OR SELECTION MENU 

3 TEST VARIABLES - SET OR DISPLAY VARIABLES FOR TEST FUNCTION 

4 CONVERT MENUS - CONVERT SELECTION/TUTORIAL MENUS TO NEW FORMAT 

5 CONVERT MSGS - CONVERT MESSAGES TO NEW FORMAT 

6 TEST MENU - TEST OLD FORMAT SPF MENUS 



Figure 76. Support Selection Menu 



A new shared variable pool, referred to as the "test pool," is 
established when option 7 is invoked. Any variables that are set 
or displayed by options 7.1 or 7.3 are from this pool. Functions 
that are invoked under option 7.2 may copy variables from and to 
the test pool by means of VGET and VPUT services. 

The test pool simply takes the place of the normal shared variable 
pool to isolate variables in the option 7 environment from vari- 
ables being used in the normal environment. 

Installations that have previously extended or custom tailored 
SPF may need to convert old format selection menus to the new pan- 
el formats. A conversion utility to assist in this process is 
provided by options 7.4. 

The following sections describe each of the support functions, 
corresponding to the six options on the support selection menu. 



Support (Option 7) 
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TEST PANEL (OPTION 7.1) 



When this option is selected, a panel is displayed that allows 
entry of the name of a panel to be tested. A message id and ini- 
tial cursor location may also be specified (Figure 77). These are 
the same parameters that may be specified (from a dialog function) 
when invoking the DISPLAY service. 

The specified panel is fetched from the panel library and dis- 
played as the end user would see it. Any variables referenced in 
the panel definition are accessed from the test pool. 



Information may be entered on the panel being tested, 
stored in the corresponding variables in the test pool. 



It is 



When the End PF key is pressed from the panel being tested, the 
option 7.1 panel is redisplayed. 



TEST PANEL 



THIS FUNCTION IS USED TO TEST SPF PANEL DEFINITIONS. THE 
PANEL WILL BE DISPLAYED AS THE END USER WOULD SEE IT. YOU MAY 
OPTIONALLY ENTER A MESSAGE ID TO BE DISPLAYED ON THE PANEL 
AND/OR THE NAME OF THE FIELD WHERE THE CURSOR IS TO BE PLACED. 



ENTER THE FOLLOWING: 

PANEL NAME ===> 
MESSAGE ID ===> 
ZURSOR FIELD ===> 



(OPTIONAL) 
(OPTIONAL) 



ENTER THE NAME OF THE PANEL TO BE TESTED OR PRESS END KEY TO EXIT 



Figure 77. Entry Panel for Testing a Panel Definition 
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TEST FUNCTION (OPTION 7.2) 



The test function option allows a dialog function or menu hierar- 
chy to be tested without having to build "scaffolding" code. 

When this option is selected, a panel is displayed that allows 
entry of a command or program name (to invoke a function), or a 
panel name to test a menu hierarchy (Figure 73). The information 
that may be entered on this panel corresponds to the parameters 
that may be specified (from a dialog function) when invoking the 
SELECT service. 

When the invoked function completes execution, or the End PF key 
is pressed from the specified panel (selection menu), the test 
function entry panel is redisplayed. 







INVOKE FUNCTION 
USED TO INVOKE A 


rta cc i cr-TTnyi me: 1,111 




THIS PANEL IS 


UK DC IX 

DIALOG 


FUNCTION (COMMAND 


OR 


PROGRAM) OR A 


SELECTION MENU (PANEL). 


THE PARAMETERS WHICH 


MAY BE ENTERED 


ARE THE SAME AS 


FOR THE 


SELECT SERVICE. 




THE 


' "OPT" AND 


"PARM" PARAMETERS ARE OPTIONAL. 




TO INVOKE 


A SELECTION 


MENU: 








PANEL 


===> 


OPT ===> 








TO INVOKE 


A COMMAND: 










CMD 


===> 










TO INVOKE 


A PROGRAM: 










PGM 


===> 


PARM ===> 








FOR ANY OF 


THE ABOVE: 










NEWAPPL 




(YES OR NO) 









Figure 78. Entry Panel for Testing a Function 
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TEST VARIABLES (OPTION 7.3) 



The test variables option allows dialog variables to be set and/or 
displayed in the test pool. It is intended for use with the test 
panel and test function options. 

When this option is selected, a panel is displayed that allows 
entry of variable names down the left-hand column. This column 
has underscores as pad characters to i ndi cate where the names may 
be entered (the underscores need not be blanked out). See 
Figure 79. 

The current contents of a variable in the test pool may be dis- 
played simply by entering the name of the variable and pressing 
the ENTER key. The value will then be displayed to the right of 
the colon. 

The contents of a variable in the test pool may be set by entering 
the variable name* changing the colon to an equal sign (=), enter- 
ing the desired value to the right of the equal sign, and then 
pressing the ENTER key. 



More than 
acti on. 



one variable may be displayed or set in the same inter- 







TEST VARIABLES - 

EXAMPLE: ABC_ 

EXAMPLE: ABC 
THEY NEED NOT BE 




TO DISPLAY 

TO SET A \ 

TO EQl 

THE UNDER* 

NAME 

ASMOPT_ 

COUNT 

PROJECT 

LIBl 


f A VARIABLE, ENTER NAME. 
/ARIABLE, CHANGE COLON 
JAL SIGN AND ENTER VALUE. 
SCORES ARE PAD CHARACTERS; 

VALUE 

LIST, TEST, TERM, RENT 

29 

SPFDEMO 

MY LIB 




= XYZ 


BLANKED OUT. 

























Figure 79. Entry Panel for Testing a Variable 
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CONVERT MENUS (OPTION 7.4) 

Installations that have previously extended or custom tailored 
SPF must ensure that the primary option menu and all lower 
selection menus that were displayed by the SPFUTIL program are in 
new format. In new SPF, these menus are displayed by the SELECT 
service. The SPFUTIL program no longer exists. 

The convert menus option provides automated conversion of some 
old format menus to new format panel definitions. Two panels are 
displayed that are similar to the move/copy utility (option 3.3). 
Old format members are read from the first ("from") library, con- 
verted to the new panel format, and stored in the second ("to") 
library. The "from" and "to" panels are shown in Figure 80. Note 
that unlike the move/copy utility, there is no option selection — 
it is always a copy operation. 

If a menu cannot be converted, a special panel is stored in the 
second library. It is a di splayable "box" panel with a message 
indicating the name of the corresponding old menu that could not 
be converted. 

The convert menus option will handle only two types of old format 
menus: 

• Lower level selection menus (below the primary option level). 
This is limited to selection menus that were designed specif- 
ically to be processed by the SPFUTIL program in the previous 
SPF products. 

• Tutorial pages. 

Do not attempt to convert a primary option menu via this utility. 
If you have added options to the old primary option menu, you must 
manually add these options to the new primary option menu. 

Also, no attempt should be made to convert foreground and batch 
menus, except for the foreground selection menu (old name FORA, 
new name ISPFORA). The foreground selection menu must be con- 
verted to new format, and may be converted with this utility. All 
other foreground and batch displays, including the batch 
selection menu are supported in old format only. See SPF-VM 
Installation and Customization for more information. 

Conversion of tutorial pages is optional; both formats are sup- 
ported. If you develop additional tutorial pages, use of the new 
format is recommended since it is simpler than the old. 

This utility cannot handle the bypassing of a tutorial page that 
is viewed only if explicitly selected (bypassed in the normal flow 
when the user keeps pressing the ENTER key). The converted page 
will not be bypassed in the normal flow. To correct the problem, 
manually change the parent panel by inserting an asterisk in front 
of the panel name in the TRANS statement. See SPF Dialog 
Management Services for more information. 
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„ CONVERT MENUS 

SPECIFY "OLD FORMAT" LIBRARY BELOW: 



FROM SPF LIBRARY: 

PROJECT ===> SPF22 
LIBRARY ===> OURMODS 
TYPE ===> MENUS 
MEMBER ===> 



(BLANK FOR MEMBER LIST, * FOR ALL MEMBERS) 



FROM CMS FILE: 
FILE ID ===> 

MEMBER ===> (FOR MACLIB OR TXTLIB) 

IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> DEVICE ADDR. ===> 



LINK ACCESS MODE ===> 



READ PASSWORD ===> 



UPDATE PASSWORD ===> 



PRESS ENTER TO SPECIFY "NEW FORMAT" LIBRARY 



COPY — OLD FORMAT SPF22. OURMODS. MENUS 
SPECIFY "NEW FORMAT" LIBRARY BELOW 

TO SPF LIBRARY: 

PROJECT ===> ISP 
LIBRARY ===> OURMODS 
TYPE ===> ISPPLIB 
MEMBER ===> 



TO CMS FILE: 
FILE ID ===> 
MEMBER ===> 
IF NOT LINKED, SPECIFY: 
OWNER'S ID ===> 



DEVICE ADDR. ===> 



LINK ACCESS MODE ===> 



UPDATE PASSWORD ===> 



REPLACE LIKE-NAMED MEMBERS ===> 



(YES OR NO) 



Figure 80. Entry Panels for Converting Menu Definitions 
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CONVERT MESSAGES (OPTION 7.5) 

k The convert messages option provides automated conversion from 

1 old format SPF message definitions to new format message defi- 

" nitions. As with option 7.4, two panels are di splayed that are 

similar to the move/copy utility. Old format members are read 
from the first library, converted to new message format, and 
stored in the second library. 

Variable fields in old format messages are converted to dummy var- 
iable names, beginning with an ampersand. These must be changed 
manually to the appropriate dialog variable names. 

Generally, installations that have previously extended or custom 
tailored SPF should not need to convert message formats. This 
utility is intended to assist in development of new dialogs that 
use messages derived from existing (old format) messages. 

The restriction on message formats is that only new format mes- 
sages may be displayed on new format panels, and old format mes- 
sages on old format panels. The new LOG service will write only 
new format messages to the SPF log file. Log messages specified 
via foreground and batch procs must remain in old format. 

TEST MENU (OPTION 7.6) 

The test menu option allows old format SPF menus to be displayed 
as the end user would see them. Old format menus are still used 
for the foreground and batch options in the SPF program develop- 
ment faci li ty. 

When this option is selected, a panel is displayed that allows 
entry of an old format menu name. See Figure 81. When the speci- 
fied menu is displayed, the initial values for the input and vari- 
able output fields are displayed as "VAL 01", "VAL 02", etc. The 
numbers correspond to the numbers on the action statements in the 
menu definition. The menu tester supports up to 50 action state- 
ments. 

When the menu is displayed, information may be entered into the 
input fields. The input and variable output fields may be ini- 
tialized prior to displaying the menu by first displaying a menu 
named SETUP. The procedure is as follows: 

1. Enter SETUP as the menu name on the test menu display. 

2. On the SETUP menu, fill in the desired parameters by overtyp- 
ing "VAL 01", "VAL 02", etc. These values will be passed as 
initial values to the menu to be tested. 

3. Press ENTER or the End PF key to return to the test menu dis- 
play. 

4. Enter the name of the menu to be tested on the test menu dis- 
play. 



) 



Support (Option 7) 145 



SPF MENU TESTER 



MENU NAME ===> 



THIS FUNCTION IS USED TO TEST OLD FORMAT SPF MENUS. DO NOT TRY TO USE THIS 
FUNCTION TO TEST NEW FORMAT SPF PANELS. 

SEVEN SPECIAL CHARACTERS ARE USED ON MENU DEFINITION STATEMENTS TO DEFINE EACH 
OF 7 MENU FIELD TYPES. THE SPECIAL CHARACTERS ARE REPLACED BY THE APPROPRIATE 
HARDWARE ATTRIBUTE BYTES, AND APPEAR ON THE SCREEN AS BLANKS. THE SPECIAL 
CHARACTERS (LISTED IN ORDER OF USE BY THE "<FIELDS>" MENU STATEMENT) ARE: 

■■'■-- INPUT (UNPROTECTED), NON-DISPLAY. 

V. - INPUT (UNPROTECTED), INTENSIFIED DISPLAY. 

I - INPUT (UNPROTECTED), NORMAL DISPLAY. 

& - OUTPUT (PROTECTED), INTENSIFIED DISPLAY. 

% - OUTPUT (PROTECTED), NORMAL DISPLAY. 

] - VARIABLE OUTPUT (PROTECTED), INTENSIFIED DISPLAY. 

[ - VARIABLE OUTPUT (PROTECTED), NORMAL DISPLAY. 

FOR FURTHER INFORMATION ON MENUS REFER TO THE SPF INSTALLATION GUIDE. 

ENTER THE NAME OF THE MENU TO BE TESTED OR PRESS PF3 (END KEY) TO EXIT. 



Figure 81. Panel for Testing Old Format Menus 



146 SPF-VM Program Reference 



TUTORIAL (OPTION T) 



1 



The tutorial option provides immediate online reference and 
instruction on how to use the SPF program development facility. 
It may be invoked from the primary option menu or via the Help PF 
key. The tutorial may be viewed sequentially from beginning to 
end, or it may be viewed randomly by selecting specific topics 
from an alphabetic index or table of contents. 

When the tutorial is invoked from the primary option menu, intro- 
ductory pages are displayed to explain how the tutorial works 
(Figure 82). Following the introduction, a table of contents is 
displayed from which the user may select a topic by entering the 
desired section number. 

When the tutorial is invoked via the Help PF key, the appropriate 
section of the tutorial is entered based on what the user was 
doing when the Help key was pressed. 

When viewing the tutorial, the user may select topics by number, 
or simply press the ENTER key to view the next topic. On any pan- 
el, the user may also enter the followi ng commands: 

to the previously viewed page 

the next topic 

a higher level list of topics 

the table of contents 

the tutorial index 

During execution of the tutorial, the four scroll PF keys are 
interpreted as follows: 

UP - display higher level list of topics 

DOWN (skip) - skip to the next topic 

LEFT (back) - display previous tutorial page 

RIGHT (next) - display next tutorial page 

The ENTER key also means "next." 

The Help PF key may be pressed at any time to display a one-page 
summary of how to use the tutorial. 

The tutorial function is terminated by pressing the End PF key. 
This causes a return either to the primary option menu or to the 
display from which the user requested help. 



BACK 


or 


B - 


- to 


back up 


SKIP 


or 


S - 


- to 


skip to 


UP 


or 


U ■ 


- to 


di splay 


TOP 


or 


T ■ 


- to 


di splay 


INDEX 


or 


I - 


- to 


di splay 
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SPF TUTORIAL 



SPF PROGRAM DEVELOPMENT FACILITY 
TUTORIAL 



THIS TUTORIAL PROVIDES ON-LINE INFORMATION ABOUT THE FEATURES AND OPERATION 
OF SPF. YOU MAY VIEW THE TUTORIAL SEQUENTIALLY, OR YOU MAY CHOOSE SELECTED 
TOPICS FROM LISTS THAT ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. 

THE TABLE OF CONTENTS CONTAINS A LIST OF MAJOR TOPICS. SUBSEQUENT PAGES 
CONTAIN ADDITIONAL LISTS THAT LEAD YOU TO MORE SPECIFIC LEVELS OF DETAIL. 
TOPICS MAY ALSO BE SELECTED FROM THE TUTORIAL INDEX. 

THE NEXT TWO PAGES CONTAIN A DESCRIPTION OF HOW TO USE THIS TUTORIAL. 

PRESS ENTER TO PROCEED TO THE NEXT PAGE, OR 

PRESS UP KEY TO GO DIRECTLY TO THE TABLE OF CONTENTS, OR 

PRESS END KEY TO RETURN TO THE PRIMARY OPTION MENU. 



TUTORIAL 

NEXT SELECTION ===> 



INTRODUCTION 



TUTORIAL 



YOU MAY VIEW THE TUTORIAL SEQUENTIALLY BY SIMPLY LEAVING THE "NEXT SELECTION" 
FIELD BLANK AND PRESSING THE ENTER KEY. ALTERNATIVELY, YOU MAY SELECT TOPICS 
FROM LISTS THAT ARE DISPLAYED ON MANY OF THE TUTORIAL PAGES. FOR EXAMPLE, 
ENTER: NEXT SELECTION ===> 3 TO SELECT TOPIC 3. 

YOU MAY ALSO ENTER ONE OF THE FOLLOWING CODES IN THE "NEXT SELECTION" FIELD 
ON ANY TUTORIAL PAGE: 

TO BACK UP TO THE PREVIOUSLY VIEWED PAGE. 

TO SKIP THE CURRENT TOPIC AND GO ON TO THE NEXT TOPIC. 

TO DISPLAY A HIGHER LEVEL LIST OF TOPICS. 

TO DISPLAY THE TABLE OF CONTENTS. 

TO DISPLAY THE TUTORIAL INDEX. 

(CONTINUED ON NEXT PAGE) 



BACK 


OR 


B 


SKIP 


OR 


S 


UP 


OR 


u 


TOP 


OR 


T 


INDEX 


OR 


I 



Figure 82. Tutorial - First Two Pages 
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APPENDIX A. SAMPLE PROBLEM 



This sample problem is a brief scenario of SPF terminal operations 
(Figure 83 through Figure 85). It is intended to serve as a dem- 
onstration that SPF has been properly installed and is opera- 
tional. It may also be useful for new users as a quick 
introduction to SPF. 

The scenario requires the installation of file ISPSAMP ASSEMBLE 
(included on the SPF basic distribution tape), which should be 
available for read-only access on the SPF system mini-disk. 

Prior to starting this sample problem, you should make sure that 
there are no files in your virtual reader. 
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ACTION 


RESULT 


1. 


LOGON AND IPL CMS (IF REQUIRED) 


1. READY MESSAGE 


2. 


TYPE "ISPF" 


2. SPF PRIMARY OPTION MENU 


3. 


SELECT UTILITIES (OPTION 3) 


3. UTILITY SELECTION MENU 


4. 


SELECT FILE UTILITY (OPTION 2) 


4. FILE UTILITY PANEL 


5. 


SELECT "SPECIFY" (S) AND ENTER: 
PROJECT : SAMPLE 

LIBRARY : USERID (YOUR VM USERID) 
TYPE : ASM 


5. SPECIFY NEW LIBRARY PANEL 


6. 


ENTER THE FOLLOWING: 


6. 'SAMPLE. USERID. ASM" IS 




ORGANIZATION : S 


SPECIFIED AS AN SPF 




RECORD FORMAT : F 


LIBRARY. FILE UTILITY 




RECORD LENGTH : 80 


PANEL IS REDISPLAYED. 




LINK ACCESS MODE : W 






(LEAVE OTHER FIELDS BLANK) 




7. 


SELECT "SPECIFY" AGAIN AND ENTER: 
FROJECT : SAMPLE (SAME AS BEFORE) 
LIBRARY : USERID (SAME AS BEFORE) 
TYPE : TEXT 


7. SPECIFY NEW LIBRARY PANEL 


8. 


(SAME ORGANIZATION, RECORD FORMAT, 


8. 'SAMPLE. USERID. TEXT' IS 




RECORD LENGTH, AND MODE LETTER 


SPECIFIED AS AN SPF 




SHOULD BE PRE-ENTERED). 


LIBRARY. FILE UTILITY 




PRESS ENTER KEY. 


PANEL IS REDISPLAYED. 


9. 


PRESS PF3 (END KEY) 


9. UTILITY SELECTION MENU 


10. 


PRESS PF3 


10. SPF PRIMARY OPTION MENU 


11. 


SELECT MOVE/COPY (OPTION 3.3) 


11. MOVE/COPY UTILITY PANEL 


12. 


SELECT COPY (C) AND ENTER: 
CMS FILE ID : ISPSAMP ASSEMBLE 


12. SECOND MOVE/COPY PANEL 


13. 


BLANK OUT CMS FILE ID AND ENTER: 


13. ISPSAMP ASSEMBLE FILE IS 




PROJECT : SAMPLE 


COPIED TO YOUR LIBRARY 




LIBRARY : USERID (YOUR VM USERID) 


(SAMPLE. USER ID. ASM) AS 




TYPE : ASM 


MEMBER ASMTEST. 




MEMBER : ASMTEST 


THE FIRST MOVE/COPY PANEL 
IS REDISPLAYED. 


1*. 


PRESS PF3 


14. SPF PRIMARY OPTION MENU 


15. 


SELECT BROWSE (OPTION 1) 


15. BROWSE ENTRY PANEL 


16. 


BLANK OUT CMS FILE ID AND ENTER: 


16. BROWSE MEMBER SELECTION 




PROJECT : SAMPLE 


LIST OF SPF LIBRARY 




LIBRARY : USERID 


'SAMPLE. USERID. ASM'. 




TYPE : ASM 


ONLY ONE MEMBER (ASMTEST) 




MEMBER : (LEAVE BLANK) 


IN LIST. 


17. 


SELECT MEMBER ASMTEST 


17. BROWSE DATA DISPLAY OF 




(ENTER S AHEAD OF MEMBER NAME) 


SAMPLE . USERID . ASM( ASMTEST ) 


18. 


SCROLL FORWARD ONE PAGE (PF8) 


18. SECOND PAGE OF ASMTEST 


19. 


SCROLL BACKWARD ONE PAGE (PF7) 


19. FIRST PAGE OF ASMTEST AGAIN 


20. 


ENTER COMMAND INPUT : 


20. STRING "COMMENT" IS 




===> FIND COMMENT 


INTENSIFIED. 


21. 


FIND NEXT OCCURRENCE OF "COMMENT" 


21. SECOND OCCURRENCE OF 




BY PRESSING PF5 


"COMMENT" IS INTENSIFIED. 



Figure 83. Sample Problem Scenario (Part 1 of 3) 
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ACTION 


RESULT 


22. PRESS PF3 


22. 


MEMBER SELECTION LIST 


23. PRESS PF3 


23. 


BROWSE ENTRY PANEL 


24. PRESS PF3 


24. 


SPF PRIMARY OPTION MENU 


25. SELECT EDIT (OPTION 2) 


25. 


EDIT ENTRY PANEL 


26. ENTER SPF LIBRARY: 


26. 


EDIT DATA DISPLAY OF 


PROJECT : SAMPLE 




SAMPLE . USERID . ASM ( ASMTEST ) 


LIBRARY : USERID 






TYPE : ASM 






MEMBER : ASMTEST 






27. FIND THE LINE CONTAINING THE 


27. 


CURSOR IS POSITIONED TO THE 


STRING "COMMENT" BY USING THE 




STRING AND SEQUENCE NUMBER 


COMMAND ===> FIND COMMENT 




IS INTENSIFIED. 


26. DELETE THE COMMENT BY PRESSING 


28. 


THE RIGHT OF LINE IS ERASED 


ERASE EOF 






29. REPEAT THE NEXT COMMENT LINE BY 


29. 


THE LINE IS REPEATED 


OVERTYPING THE FIRST DIGIT OF 






THE LINE NUMBER WITH "R". 






30. ENTER THE COMMAND ===> PRINT ON 


30. 


THIS SETS PRINT MODE ON FOR 
AUTOMATIC SOURCE LISTINGS. 


31. TRY OUT MORE EDIT COMMANDS IF 


31. 


GOOD LUCK 


YOU LIKE, BUT REMEMBER THIS 






PROGRAM MILL BE ASSEMBLED LATER. 






32. PRESS PF3 


32. 


MEMBER ASMTEST IS SAVED IN 
LIBRARY SAMPLE. USERID. ASM 
AND A LISTING OF THE MEMBER 
IS PLACED IN THE SPF LISTING 
FILE. THE EDIT ENTRY PANEL 
IS DISPLAYED. 


33. PRESS PF3 


33. 


SPF PRIMARY OPTION MENU 


34. SELECT FOREGROUND (OPTION 4) 


34. 


FOREGROUND SELECTION MENU 


35. SELECT SYSTEM ASSEMBLER 


35. 


FOREGROUND ASSEMBLY PANEL 


36. ENTER ASSEMBLER INPUT: 


36. 


ASSEMBLER IS INVOKED. 


PROJECT : SAMPLE 




TERMINAL OUTPUT IS WRITTEN 


LIBRARY : USERID 




AT THE TOP OF A BLANK 


TYPE : ASM 




SCREEN. WHEN "MORE..." 


MEMBER : ASMTEST 




APPEARS, PRESS PA2 TO 


ASSEMBLER 




CONTINUE. TEXT FILE IS 


OPTIONS : LIST TEST RENT 




PLACED IN YOUR SPF LIBRARY 
SAMPLE. USERID. TEXT AS 
MEMBER ASMTEST, AND LISTING 
FILE (NAMED ASMTEST) IS 
WRITTEN ON YOUR A-DISK. 


37. PRESS PF3 


37. 


FOREGROUND SELECTION MENU 


48. PRESS PF3 


38. 


SPF PRIMARY OPTION MENU 


39. SELECT BATCH (OPTION 5) 


39. 


BATCH SELECTION MENU 


40. SELECT ASSEMBLER (OPTION 1) AND 


40. 


BATCH ASSEMBLY PANEL 


ENTER JOB INFORMATION AS REQUIRED 






BY YOUR INSTALLATION. 







Figure 84. Sample Problem Scenario (Part 2 of 3) 
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ACTION 


RESULT 


41. ENTER ASSEMBLER INPUT: 

PROJECT : SAMPLE 
LIBRARY : USERID 
TYPE : ASM 
MEMBER : ASMTEST 
ASSEMBLER 
OPTIONS : TERM 

OBJ NODECK LIST 

42. PRESS PF3 


41. CONTROL COMMANDS FOR 
ASSEMBLING ASMTEST ARE 
GENERATED. THE BATCH 
SELECTION MENU IS 
REDISPLAYED. 

42. THE JOB IS SUBMITTED TO 
THE CMS BATCH MACHINE. 
WHEN "HOLDING" APPEARS, 
PRESS PA2. PRIMARY OPTION 
MENU IS REDISPLAYED. 


AS THE JOB EXECUTES IN THE BATCH MACHINE, STATUS MESSAGES WILL BE 
RETURNED TO YOU. IN PARTICULAR, YOU WILL RECEIVE A MESSAGE WHEN THE 
ASSEMBLY IS COMPLETE INDICATING THAT THE TEXT AND LISTING FILES HAVE 
BEEN SPOOLED TO YOUR READER. DO NOT EXECUTE STEP 44 OF THIS SCENARIO 
UNTIL YOU HAVE RECEIVED THE COMPLETION MESSAGE. 


43. SELECT TUTORIAL (OPTION T) 

44. SELECT READER UTILITY (OPTION 3.7) 

45. SELECT INSERT (OPTION I) AND ENSURE 
THAT THE TARGET SPF LIBRARY FOR THE 
TEXT FILE IS SAMPLE. USERID. TEXT 

46. SELECT READ (OPTION R) AND 
RENAME TO : ASMTEST2 LISTING 
THEN PRESS ENTER. 

47. PRESS PF3 


43. START OF SPF TUTORIAL IS 
DISPLAYED. FOLLOW THE 
DIRECTIONS TO LEARN MORE 
ABOUT SPF. WHEN YOU ARE 
DONE, PRESS PF3 TO RETURN 
TO THE PRIMARY OPTION MENU. 

44. READER UTILITY PANEL 

45. READER UTILITY PANEL IS 
REDISPLAYED, SHOWING 
THAT THE FILE WAS MOVED 
INTO YOUR SPF LIBRARY, 
AND THAT THE LISTING IS 
NOW THE NEXT FILE IN 
YOUR READER. 

46. READER UTILITY PANEL IS 
REDISPLAYED, SHOWING 
THAT THE LISTING WAS 
LOADED ONTO YOUR A-DISK, 
AND THAT YOUR READER IS 
NOW EMPTY. 

47. SPF PRIMARY OPTION MENU 


IF YOU HAVE FOLLOWED THIS SCENARIO, YOU SHOULD HAVE TWO LISTING FILES 
ON YOUR A-DISK, ONE NAMED ASMTEST (FROM THE FOREGROUND ASSEMBLY), AND 
THE OTHER NAMED ASMTEST2 (FROM THE BATCH ASSEMBLY). TRY BROWSE 
(OPTION 1) TO REVIEW THE LISTINGS, AND TRY EXPERIMENTING WITH OTHER 
SPF OPTIONS. WHEN YOU ARE DONE, RETURN TO THE PRIMARY OPTION MENU. 


48. (AT PRIMARY OPTION MENU) 
PRESS PF3 

49. SELECT OPTION P FOR BOTH THE LOG 
AND LIST FILES, AND PRESS ENTER. 

50. YOU ARE NOW OUT OF SPF. TO EXIT 
FROM CMS TYPE "LOGOFF". 


48. SPF TERMINATION PANEL 

49. THE LOG AND LIST FILES 
ARE CLOSED AND RELEASED 
FOR PRINTING. 

50. END OF SAMPLE 



Figure 85. Sample Problem Scenario (Part 3 of 3) 
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APPENDIX B. SPF LISTING FORMATS 



If PRINT mode is on, the SPF editor automatically generates a 
source listing upon completion of editing. Source listings may 
also be obtained via the "print" option of the SPF library utility 
(option 3.1) and the move/copy utility (option 3.3). 

A sample source listing is shown in Figure 86. 

For an SPF library* information at the top of the page includes 
project* library, type* member, current version, and modi f i cati on 
level. The member name is also repeated at the right for ease of 
filing. For a CMS file, the file id (and member name for a MACLIB 
or TXTLIB) are indicated. The header lines also include user id, 
date and time that the listing was produced, and page number. 

A column positioning line is printed following the heading and 
preceding the actual data. The "start column" is printed to the 
left of each line, indicating the position of the first non-blank 
character In each line. For SPF library members with statistics, 
asterisks may be printed to the right of each line, as follows: 

• If the modification flag (columns 79-80) in the line is 00, no 
asterisks arG printed. 

• If the modification flag is non-zero but differs from the cui — 
rent modification level of the member, a single asterisk (X) 
i s pri nted. 

• If the modification flag is non-zero and has the same value as 
the current modification level of the member, two asterisks 
(x*) are printed. 

The asterisks allow the listing to be scanned quickly for lines 
that were added or changed since the version was created (*) and 
for lines that were added or changed during the last update (**). 

SPF provides index listings, upon user request, via the "index" 
option of the library utility (option 3.1). A sample index list- 
ing for an SPF source library is shown in Figure 87. The heading 
information includes: project, library, and type, date and time 
that the listing was produced, and page number. This is followed 
by general information about the library. Following this, the 
member name and statistics are printed for each member, arranged 
in alphabetical order. 

Finally, a sample SPF log listing is shown in Figure 88. The log 
contains a message for each significant user action, such as sav- 
ing edited data, moving members from one library to another, or 
submitting a batch job. 
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4> 



-o 

I 

< 

TJ 

O 

IQ 

*» 
Q» 
3 

;*> 

(D 

O 
"1 

10 

o 

ID 





PROJECT: SPFDEMO MEMBER: COINS DATE: 79/05/18 




COINS 






LIBRARY: MYLIB LEVEL: 01.04 TIME: 17:22 










TYPE: PLI USERID: 0RR PAGE: 01 OF 01 








START 




MOD 






COL 


+ 1 + g + 3 + 4 + 5 + ^ + 7 + 3 


FLAGS 






2 


COINS: 00010001 


* 






4 


PROCEDURE OPTIONS (MAIN); 00020000 








6 


DECLARE 00030000 








8 


COUNT FIXED BINARY (31) AUTOMATIC INIT (1), 00040000 








8 


HALVES FIXED BINARY (31)» 00050000 








8 


QUARTERS FIXED BINARY (31), 00060003 


* 






3 


DIMES FIXED BINARY (31), 00070000 








8 


NICKELS FIXED BINARY (31), 00080004 


** 






8 


SYSPRINT FILE STREAM OUTPUT PRINT} 00090000 








6 


DO HALVES = 100 TO BY -50 J 00100000 








8 


DO QUARTERS = (100 - HALVES) TO BY -25? 00110000 








10 


DO DIMES = ((100 - HALVES - QUARTERS )/10)*10 TO BY -10; 00120000 








12 


NICKELS = 100 - HALVES - QUARTERS - DIMES; 00130000 








12 


PUT FILE( SYSPRINT) DATA(COUNT, HALVES, QUARTERS, DIMES, NICKELS) ;00140000 








12 


COUNT = COUNT + 1; 00150000 








10 


END; 00160000 








8 


END; 00170000 








6 


END; 00180000 








4 


END COINS; 00190001 


X 







Figure 86. Sample Source Listing 



> 

T3 
ID 

3 

a 



w 



-n 



ut 

3 
IQ 

-n 
o 

-j 
3 
Qi 
rt- 
W 



PROJECT: 


SPFDEMO 












DATE: 79/05/08 


LIBRARY: 


MY LIB 












TIME: 17:22 


TYPE: 


PLI 












PAGE: 001 


ATTRIBUTE 


DATA: 


LOCATION 


DATA: 


LINK ACCESS 




NUMBER OF MEMBERS: 12 


ORGANIZATION: S 


OWNER ' 


S ID: ORR 


MODE FOR UPDATE: 


MW 






RECORD 


FORMAT: F 


DEVICE 


. ADDR: 193 










RECORD 


LENGTH: 60 














MEMBER 


VERS. MOD 


CREATION 


DATE AND TIME 


CURRENT 


INITIAL 


MODIFIED 


USER 


NAME 


LEVEL 


DATE 


LAST MODIFIED 


NO. LINES 


NO. LINES 


NO. LINES 


ID 


ACCOUNT 


01.00 


79/01/09 


79/01/09 17:07 


21 


21 





KLEIN 


ACCT1 


01.01 


79/01/09 


79/04/23 14:52 


99 


193 





KLEIN 


ACCT2 


01.00 


79/01/09 


79/01/09 17:07 


20 


20 





ORR 


COINS 


01.04 


79/04/24 


79/04/24 16:20 


19 


19 


4 


ORR 


COMPX 


01.00 


79/01/09 


79/01/09 17:08 


44 


44 





ORR 


COMPY 


01.01 


79/01/14 


79/01/14 12:30 


13 


13 


1 


ORR 


DCLS 


01.00 


79/04/23 


79/04/23 15:14 


20 


20 





MOSTON 


LISTOUT 


01.02 


79/04/23 


79/04/23 15:00 


17 


13 


6 


KLEIN 


MAIN 


01.00 


79/01/09 


79/01/09 17:08 


4 


4 





MOSTON 


TESTDIR 


01.02 


79/04/23 


79/05/06 17:04 


30 


43 


10 


MOSTON 


MAXIMUMS: 01.04 


79/04/24 


79/05/06 17:04 


99 


193 


10 




TOTALS 


: 






287 


390 


21 




END OF 


MEMBER LIST 
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"0 

-n 
i 

< 

13 

-J 
O 
10 

1 

01 
3 

/O 

ID 
-h 
(D 

1 
(D 
3 
O 
ID 



TIME 



*** SPF TRANSACTION LOG *** 



USERID: JOSLIN 



DATE: 79/05/29 PAGE: 1 



17:11 


START OF SPF 


SESSION L 


17:12 


UTILITY - 


SPECIFY 


17:13 


UTILITY - 


MOVE/COPY 


17:13 






17:13 


UTILITY - 


MOVE/COPY 


17:13 






17:13 


UTILITY - 


MOVE/COPY 


17:13 






17:13 


UTILITY - 


MOVE/COPY 


17:13 






17:14 


EDIT 


SAVE 


17:15 


EDIT 


CREATE 


17:15 


EDIT 


SAVE 


17:15 


EDIT 


SAVE 


17:16 


EDIT 


SAVE 


17:17 


UTILITY - 


DELETE 


17:17 


CMS 


COMMAND 


17:17 


UTILITY - 


SPECIFY ■ 


17:19 


BATCH 


JOBSTEP ■ 


17:19 


BATCH 


JOB 


17:20 


END OF SPF SESSION LOG 



- LIBRARY 'SPFDEMO.NEWLIB.PLI' CREATED ON JOSLIN 191. 

■ SPFDEMO.MYLIB.PLK ACCOUNT) COPIED 

TO SPFDEMO.NEWLIB.PLKACCTXX) 

■ SPFDEM0.MYLIB.PLKACCT1) COPIED 

TO SPFDEMO.NEWLIB.PLKACCTYY) 

■ SPFDEM0.MYLIB.PLKACCT2) COPIED 

TO SPFDEMO.NEWLIB.PLKACCTZZ) 

■ SPFDEMO.MYLIB.PLK COINS) COPIED 

TO SPFDEMO.NEWLIB.PLK COINS) 

• SPFDEMO.NEWLIB.PLK COINS) - MEMBER SAVED 

■ SPFDEMO.NEWLIB.PLKACCTNEW) - MEMBER CREATED 

• SPFDEMO.NEWLIB.PLKACCTXX) - MEMBER SAVED 

■ SPFDEMO.NEWLIB.PLKACCTYY) - MEMBER SAVED 

• SPFDEMO.NEWLIB.PLKACCTZZ) - MEMBER SAVED 

• SPFDEMO.NEWLIB.PLKACCTZZ) DELETED 
•9R 

LIBRARY 'SPFDEMO.NEWLIB.TEXT' CREATED ON JOSLIN 191, 
PLI OPT COMPILE — TO SPFDEMO.NEWLIB.TEXK COINS) 
JOSLIN U101 SUBMITTED. 
] 5 __. 



Figure 88. Sample Log Listing 



APPENDIX C. SUMMARY OF SPF COMMANDS 



MEMBER LIST COMMANDS 



The following commands may be entered in the command input field 
(line 2 of the logical screen) on member list displays. 

LOCATE Causes direct scrolling to the specified member name (may 
be entered on any member 1 i st di splay) . 

SELECT Causes the specified member name to be selected for 
browse, edit, or SCRIPT/VS (invalid on other utility mem- 
ber list displays). Allows selection of a member which is 
not i n the li st . 

On member list displays, the following one-character commands may 
be entered at the beginning of a line, ahead of the member name. 

S (select) Causes the member to be selected for browse, edit, 
move/copy, reset, or SCRIPT/VS utility (invalid under 
the library utility). 

P (print) Causes the member to be printed (valid only under the 
library utility). 

R (rename) Causes the member to be renamed (valid only under the 
library utility). The new name must be entered to the 
right of the member name. 

D (delete) Causes the member to be deleted (valid only under the 
1 i brary uti li ty) . 

B (browse) Causes the member to be browsed (valid only under the 
li brary uti li ty ) . 



BROWSE COMMANDS 



The following commands may be entered in the command input field 
(line 2 of the logical screen) under browse, and also under 
SCRIPT/VS and the "display" option of the project utility. 

LOCATE Causes direct scrolling to the specified relative line 
number or label. 

.xxxxx Establishes a label (SPF internal symbol) which is 
equated to the top line on the screen. It can then be 
used with the LOCATE command to cause scrolling directly 
to that line. 



COLS 

RESET 
FIND 

CAPS 

HEX 



Causes display of 
posi ti ons. 



a line that identifies column 



Removes the column identification line from display. 

Causes the data to be scanned for one or all occurrences 
of a character string. The cursor is repositioned to the 
beginning of the first occurrence, if it is found. 

Causes character strings, entered as part of the FIND 
command, to be converted to upper case. CAPS OFF causes 
character strings to be left as-is. 

Causes data to be displayed in hexadecimal format. HEX 
OFF restores normal display format. 
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EDIT LINE COMMANDS 



Under edit* line commands may be entered at the beginning of a 
line by overtyping the line number. 

COLS Causes display of a line that identifies column 
posi ti ons. 

I (insert) Causes a new line to be inserted after this line. 

D (delete) Causes the line to be deleted. 

R (repeat) Causes the line to be repeated and the duplicate copy 
to be inserted after this line. 

M (move) Identifies a line to be moved. 

C (copy) Identifies a line to be copied. 

A (after) Identifies the line after which copied or moved lines 
are to be inserted. 

B (before) Identifies the line before which copied or moved 
lines are to be inserted. 

MASK Causes display of the insert mask* to allow pre-entry 
of data on inserted lines. 

< (left) Causes the contents of the line to be "data" shifted 
left. 

> (right) Causes the contents of the line to be "data" shifted 
right. 

( (left) Causes the contents of the line to be "column" 
shifted left. 

) (right) Causes the contents of the line to be "column" 
shi f ted ri ght . 

BOUNDS Causes display of the column boundary line* to allow 
redefinition of boundary positions. 

X (exclude) Causes the line to be excluded from display. May also 
be used to limit the scope of the FIND and CHANGE com- 
mands. 

S (show) Causes an excluded line to be redisplayed. 

F (first) Causes the first line in a block of excluded lines to 
be redisplayed. 

L (last) Causes the last line in a block of excluded lines to 
be redisplayed. 

TABS Causes display of the tab line, to allow definition 
of hardware* software* and logical tab positions. 

TE Facilitates bulk text entry by allowing the user to 

type continuously without regard to the line number 
area. 

TS Causes splitting of a line into two lines at the 

designated cursor position to facilitate the 
insertion of new material in existing text. 

TF Causes ref lowing of a paragraph of text from the 

cursor position to the end of the paragraph. 

(overlay) Causes data to be copied or moved "over" the existing 
data on one or more lines. Blank characters in the 
receiving line(s) are overlayed with corresponding 
characters in the source line(s). 
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The following line commands may be entered with double characters 
to indicate the beginning and end of a block of lines. 

"data" shift left 
"data" shift right 
"column" shift left 
"column" shift right 
overlay 

The following line commands may incorporate a number (n) consist- 
ing of one or more digits. 



DD 


- 


Block 


delete 


<< 


- Block 


RR 


- 


Block 


repeat 


>> 


- Block 


MM 


- 


Block 


move 


(( 


- Block 


CC 


- 


Block 


copy 


)) 


- Block 


XX 


- 


Block 


exclude 


00 


- Block 



In - 

Dn - 

Rn - 

RRn - 
Mn 

Cn - 

An - 

Bn - 

<n - 
<<n - 

>n - 
>>n - 
(n - 
(Cn - 
)n - 
))n - 
Xn - 
Sn - 
Fn - 
Ln - 
TEn - 
TSn - 
TFn - 
On - 



Insert n lines following this line 
Delete n lines starting at this line 
Repeat this line n times 
Repeat block of lines n times 
Move n lines starting at this line 
Copy n lines starting at this line 
Insert n copies of the moved/copied 
after this line 



moved/copi ed 
posi ti ons 



li ne(s) 
li ne(s) 



Insert n copies of the 
before this line 
Data-shift line left n 
Data-shift block of lines left n positions 
Data-shift line right n positions 
Data-shift block of lines right n positions 
Column-shift line left n positions 
Column-shift block of lines left n positions 
Column-shift line right n positions 
Column-shift block of lines right n positions 
Exclude n lines starting at this line 
Show n lines in a block of excluded lines 
Show first n lines in a block of excluded lines 
Show last n lines in a block of excluded lines 
Insert n text entry lines following this line 
Insert n new lines between the split lines 
Flow text from left bound to column position n 
Overlay n lines 



If a number is not entered* the default is 1 except for: 

• The shift commands (whi ch default to 2 column positions) 

• The TE command (defaults to the number of lines remaining on 
the screen) 

• The TF command (defaults to the specified column boundaries) 



EDIT PRIMARY COMMANDS 



Under edit, the following commands may be entered in the command 
input field (line 2 of the logical screen). 

LOCATE Causes direct scrolling to the specified line number. 

NUMBER Causes sequence numbers to be generated for any new 
lines that are created via insert, repeat, or copy. NUM- 
BER OFF causes lines to be generated without numbers. 

RENUM Renumbers each line and turns on NUMBER mode. 

UNNUM Causes sequence numbers to be set to blanks and turns off 
NUMBER mode. 

AUTONUM If edit is in NUMBER mode, causes sequence numbers to be 
automatically renumbered whenever a save is done. 
AUTONUM OFF bypasses automatic renumbering at save time. 

STATS Causes SPF statistics to be generated or updated 
whenever a member is saved, created, or replaced. STATS 
OFF causes members to be stored without statistics. 
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PRINT Causes a source listing of the edited data to be 
automatically recorded in the SPF list file whenever 
edit is terminated by pressing the End PF key. PRINT OFF 
bypasses automatic source listings. 

RECOVERY Enables the SPF edit recovery function. If there i s a 
subsequent system failure, the user can recover the SPF 
edit session up to the point of failure. RECOVERY OFF 
disables the edit recovery function. 



RESET 

SUBMIT 

SAVE 

CANCEL 
FIND 

CHANGE 



Causes a general resetting of intensified messages, 
incomplete line commands, and special lines. 

Causes the data being edited to be punched to another 
virtual machine for batch execution. 

Causes the data to be stored back into the edit file and 
editing to continue. 

Causes editing to be terminated without saving the data. 

Causes the data to be scanned for one or all occurrences 
of a character string. The cursor is repositioned to the 
beginning of the first occurrence, if it is found. 

Causes one or all occurrences of a character string to be 
replaced with a second string. The cursor is reposi- 
tioned to the end of the first occurrence, if it is 
found. 



COPY Causes data to be copied from another source and 
inserted at a point indicated with the A (after) or B 
(before) line command. The other source can be a member 
of an SPF library or MACLIB, or a sequential CMS file. 

MOVE Same as COPY, except that the other source is deleted 
after the copy operation. 

CREATE Causes a line or block of lines to be stored in any SPF 
library or MACLIB as a new member. The line(s) to be 
stored are designated with the C or CC (copy), or M or MM 
(move) line commands. 

REPLACE Same as CREATE, except that it allows an existing member 
or a sequential CMS file to be replaced. 

NULLS Replaces trailing blanks on the screen with null 
characters. NULL OFF causes trailing blanks to be sent 
to the screen as blanks. 

TABS Enables the use of "hardware" or "logical" tabs at user 
defined positions (specified via the tabs line command). 
TABS OFF disables the use of "hardware" or "logical" 
tabs. 

PROFILE Causes the display of the current setting of edit modes 
(NUMBER, AUTONUM, STATS, PRINT, CAPS, NULLS, TABS, HEX, 
and RECOVERY). Also displays the MASK, TABS, and BOUNDS 
lines whenever they have settings other than their 
defaults. 

HEX Causes data to be displayed in hexadecimal format. HEX 
OFF restores normal display format. 

CAPS Causes alphabetic data entered from the terminal to be 
translated to upper case, including FIND and CHANGE 
strings, CAPS OFF causes alphabetic data to be left 
as-i s. 
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APPENDIX D. SPF COMMAND SYNTAX - QUICK REFERENCE SUMMARY 



MEMBER LIST COMMANDS 



Primary Commands: 
LOCATE member-name 
SELECT membei — name 



Line Selection Commands: 

S (select) - except opt. 3.1 

P (print) - option 3.1 only 

R (rename) - option 3.1 only 

D (delete) - option 3.1 only 

B (browse) - option 3.1 only 



BROWSE COMMANDS 



.xxxxx 

COLS 

RESET 



FIND string [ NEXT /ALL/FIRST/LAST/PREV3 
[CHARS/PREFIX/SUFFIX/W0RD3 
Ccol-1 Ccol-23] 

CAPS C0N/0FF3 

HEX C0N/0FF3 EVERT/DATA3 



EDIT LINE COMMANDS 



Basic Commands: 

COLS 

I, In 

D, Dn, DD 

R, Rn, RR, RRn 

M, Mn, MM 

C, Cn, CC 

A, An 

B, Bn 



Advanced Features: 



( i nsert) 

(delete) 

( repeat) 

(move) 

(copy) 

(after) 

(before) 



MASK 
<, <n, 
>, >n, 
(, (n, 
), )n, 
BOUNDS 
X, Xn, 
S, Sn 
F> Fn 
L, Ln 
TABS 



«, 

»> 
((, 
)), 

XX 



<<n 
>>n 

((n 
))n 



(data 
(data 
(cols 
(cols 



left) 
ri ght) 
left) 
ri ght) 



(exclude) 
(show) 
(f i rst ) 
(last) 



> 



Text Preparation Features: 



TE, TEn 
TS, TSn 
TF, TFn 



(text entry) 
(text split) 
(text flow) 



0, On, 00 (overlay) 
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EDIT PRIMARY COMMANDS 



General Commands: 

LOCATE line-number 

NUMBER CON/OFF] 

CSTD3 CC0B0L3 [DISPLAY] 

RENUM CSTD] [COBOL] [DISPLAY] 

UNNUM 

AUTONUM [ON/OFF] 

STATS EON/OFF] 

PRINT [ON/OFF] 

RECOVERY [ON/OFF] 

RESET 

SUBMIT machine-id 

SAVE 

CANCEL 



Advanced Features; 

COPY [membei — name] 

MOVE * [membei — name] 

CREATE [member-name] 

REPLACE [membei — name] 

NULLS [ON/OFF] [ALL] 

TABS [ON/OFF] 

[tab-char] [ALL] 

PROFILE [name] [number] 

HEX [ON/OFF] 

[VERT/DATA] 



Text Preparation Features: 
CAPS [ON/OFF] 



Find and Change Commands; 

FIND string-1 [ HEXT /ALL/FIRST/LAST/PREVJ 
[ CHARS /PREFIX/SUFFIX/WORD] 
[X/NX] 
[col-1 [col-2]3 

CHANGE string-1 string-2 [ NEXT /ALL/FIRST/LAST/PREV] 

[ CHARS /PREFIX/SUFFIX/K0RD3 
[X/NX] 
[col-1 [col-2]] 



FIND/CHANGE STRINGS (BROWSE AND EDIT) 



Character String Format 



Simple string: 
Delimited string: 
Hex string: 
Text string: 
Picture string: 
Previous string: 



cccccc 

'ccccc' 

X'hhhh' 

T'cccc* 

P'ssss* 



(no embedded blanks or commas) 

or "ccccc" 

or 'hhhh'X 

or "cccc'T 

or 'ssss'P 

(single aster i sk) 



Picture Strings - Special Characters: 



p»=» 

P'.» 
P'S f 
pt-i 

p»a' 
P i<i 

p«>» 
P»$t 



any character (don't care) 

any non-blank character 

any non-di splayable (invalid) character 

any numeric character (0-9) 

any non-numeric character 

any alphabetic character (upper or lower case) 

any lower case alphabetic character 

any upper case alphabetic character 

any special character (not alpha or numeric) 
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APPENDIX E. SPF-MVS AND SPF-VM DIFFERENCES 



The System Productivity Facility (SPF) supports two environments: 

• MVS Time Sharing Option (SPF-MVS) 

• VM/SP Conversational Monitor System (SPF-VM) 

Following is a summary of differences between the two environ- 
ments pertaining to the SPF program development facility. 

• On the primary option menu, option 6 is: 

SPF-MVS: Enter TSO Command or CLIST 
SPF-VM : Enter CMS Command or EXEC 

• Panels and tutorials which refer to "data sets" in SPF-MVS 
refer to "files" in SPF-VM. The first part of an entry panel 
(browse or edit, for example) allows specification of an SPF 
library. The format is identical in SPF-MVS and SPF-VM: 



SPF LIBRARY: 
PROJECT ===> 
LIBRARY ===> 
TYPE ===> 
MEMBER ===> 



(BLANK FOR MEMBER SELECTION LIST) 



The second part of an entry panel differs as follows, 
SPF-MVS: 



For 



OTHER PARTITIONED OR SEQUENTIAL DATASET: 
DATASET NAME ===> 
VOLUME SERIAL ===> (IF NOT CATALOGED) 



For SPF-VM: 



CMS FILE: 






















FILE ID 


=rr> 




















MEMBER 


== = > 




(FOR 


MAC LIB 


OR 


TXT LIB) 










IF NOT 


LINKED , 


SPECIFY 


















OWNER ' S 


ID === 


> 


DEVICE ADDR. 


z: 


:=> 


LINK 


ACCESS 


MODE 


===> 



I 



The third part of an entry panel contains an (OS) password 
field for SPF-MVS. For SPF-VM, this part of the panel may 
contain a read password field, an update password field, or 
both, depending on the type of function. In SPF-MVS, pass- 
words pertain to data sets; in SPF-VM, they pertain to mi ni- 
di sks. 

Implementation of SPF libraries is accomplished in SPF-MVS 
using partitioned data sets, while SPF-VM uses sequential CMS 
files and/or MACLIBs and TXTLIBs (under user option). 

SPF-MVS supports printing on either: 

System printer (via submission of a background job) 
328x printer (via interface to DSPRINT command) 

SPF-VM supports printing via the CMS PRINT command. The out- 
put may be directed to the system printer or spooled to anoth- 
er user (or machine), which may be at a remote node in the 
network. 

Specification of "job statement information" occurs in 
SPF-MVS on the background selection menu and all panels pei — 
taining to hardcopy output. SPF-VM provides job information 
on the batch selection menu only. All other output is accom- 
plished with the CMS PRINT, PUNCH, or DISK DUMP commands, 
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rather than via job submission. 

Additionally, job statement information syntax and keywords 
sre different, reflecting differences between CMS batch job 
streams and VS2 JCL. 

Differences in foreground processing (option 4) and back- 
ground (batch) processing (option 5) are as follows: 

SPF-MVS: Compiled/assembled output (object module) goes into 
an SPF library whose "type" is OBJ. Link edit out- 
put (load module) goes into an SPF library whose 
"type" is LOAD. 

SPF-VM: Compiled/assembled output (object module) goes into 
an SPF library whose "type" is TEXT. Linkage edit- 
ing is not supported, but the LOAD command is sup- 
ported. 

Option 3.2 (dataset/f i le utility). The following suboptions 
of this utility in SPF-MVS: 

A - Allocate new data set 
C - Catalog data set 
U - Uncatalog data set 

are replaced in SPF-VM with: 

S - Specify new SPF library 
U - Unspecify SPF library 

There is no need for an "allocate file" capability under 
SPF-VM, since space allocation is handled automatically by 
VM/CMS. There is, however, a need to pre-specify SPF library 
identifiers and file characteristics to SPF-VM. 

Option 3.4. In SPF-MVS this is the catalog management utili- 
ty. In SPF-VM it is replaced with the project utility, which 
provides a similar function for SPF libraries. 

Option 3.6. In SPF-MVS this is the hardcopy utility. In 
SPF-VM it is replaced with the spool utility, which provides 
similar functions for printing and punching, and also allows 
spooling to another user (or machine), which may be at a 
remote node in the network. 

Option 3.7. In SPF-MVS this is the list VTOC utility, which 
has no equivalent in SPF-VM. It is replaced in SPF-VM with 
the reader utility. 

Option 3.8. In SPF-MVS this is the outlist utility, which has 
no equivalent in SPF-VM. It is replaced in SPF-VM with the 
retrieve utility. 
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APPENDIX F. SPF LIBRARY SPECIFICATION AND USAGE 



Before reading this appendix, please review the section entitled 
"SPF Libraries" in the general description section of this docu- 
ment. 



GUIDELINES FOR LIBRARY SPECIFICATION 

Each SPF library must be specified via the SPF file utility 
(option 3,2) before it can be used. The name of the library along 
with the following information must be specified: 

SPF library attributes: 

Organization (S = set of files, M = MACLIB, T = TXTLIB) 

Record format (F = fixed, V = variable) 

Record length (1 tn 32767 bytes) 

SPF library location: 

Owner's id (blank for your user id) 
Device addr. (blank for '191') 

Link access mode for update: 
Mode letters (M, W, or MW) 

For organization S (set of files): 

Filetype (blank for SPF-generated name) 

For organization M or T (MACLIB or TXTLIB): 

Filename (blank for SPF-generated name) 



Naming Conventions 

An SPF library is always identified by a 3-component name (project 
name, library name, and type), where: 

• "project name" is the common identifier for all libraries 
belonging to the same programming project. 

• "library name" identifies the particular set of libraries 
(i.e., the level within the library hierarchy). For a private 
library, the user id is an appropriate library name. 

• "type" identifies the type of information in the library. The 
SPF type qualifier need not conform to the standard CMS naming 
conventions, with one exception: If the library is to contain 
TEXT (object) modules, the SPF type qualifier must be TEXT 
regardless of whether the library organization is "S" (set of 
sequential files) or "T" (TXTLIB). 

Each component of the name may be up to eight alphameric charac- 
ters, of which the first must be alphabetic. The same rule 
applies to member names. 



Library Organization 

The library organization must be one of the following: 

S - The library will be maintained as a set of CMS sequential 
files, all with the same filetype. The CMS filenames will be 
the same as the SPF member names, and the CMS filetype may be 
anything which uniquely identifies the set of files on the 
mi ni di sk. 
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M - The library will be maintained as a CMS file with a filetype 
of MACLIB. The CMS filename may be anything which uniquely 
identifies the MACLIB on the minidisk. The member names in 
the MACLIB will be the same as the SPF member names. 

T - The library will be maintained as a CMS file with a filetype 
of TXTLIB. The CMS filename may be anything which uniquely 
identifies the TXTLIB on the minidisk. The member names in 
the TXTLIB will be the same as the SPF member names. 

Libraries containing documentation to be processed by the 
SCRIPT/VS utility (option 3.9) must have an organization of "S", 
but they need not have an SPF type qualifier of SCRIPT nor a CMS 
filetype of SCRIPT. 

Libraries containing TEXT (object) modules must have an organiza- 
tion of "S" or "T", and the SPF type qualifier must be TEXT. (For 
organization "S" the CMS filetype need not be TEXT.) 

Any other libraries may have an organization of "S" or "M". There 
are no restrictions on the SPF type qualifier, nor the CMS 
filetype (for organization "S"). 

Following ar& additional suggestions for specifying library 
organization: 

• Libraries which are frequently updated (especially the lowest 
level libraries in a project hierarchy) should be assigned an 
organization of "S". This will eliminate the need for com- 
presses. 

• As a performance consideration, it may be desirable to assign 
higher level libraries an organization of "M" or "T" if one or 
more of the following applies: 

The library has many members. 

The library is infrequently updated. 

The library contains members which are included or copied 
by other members during a compile or assembly. See "Fore- 
ground/Batch Processing", which follows, for a discussion 
of included members. 



Record Format and Length 

Libraries which have an organization of "M" or "T" must have a 
record format of "F" (fixed), and a record length of 80. 
Libraries which have an organization of "S" may have a record foi — 
mat of either "F" or "V" (variable), and a record length from 1 to 
32767. Note, however, that the SPF editor will not process any 
data with a record length less than 10. 

For format "F", the record length indicates the exact length of 
each record in the library. For format "V", the record length 
indicates the maximum allowable length of any record in the 
library. 



Library Location 

Each SPF library must be wholly contained on one minidisk, which 
is specified via owner's user id and vi rtual devi ce address. 

More than one SPF library may be assigned to the same minidisk, 
and SPF libraries may co-reside on the same minidisk with other 
CMS files (which are not SPF li brari es) . Be careful, however, to 
guard against conflicting CMS filetypes or filenames (see "Unique 
Identifier" and "Foreground/Batch Processing" which follow). 
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Following are additional suggestions for specifying library 
locati on: 

• Typically, the lowest level libraries in a project hierarchy 
are private libraries and should reside on a minidisk which is 
owned by the user of the library (and should have an organiza- 
tion of "S"). 

• Higher level libraries in the project hierarchy are typically 
common libraries which are accessed for reading by anyone on 
the project, but are controlled (updated) by one designated 
individual. It is a good idea for these libraries to be on 
minidisks which are owned by the person who will be updating 
them, and which are write protected (i.e., no update password 
or an update password known only to the owner). 

• If higher level libraries are to be protected against unau- 
thorized reading by anyone outside the project, they should 
reside on minidisks which all have the same read password. 
The reason for this is that SPF panels provide a single read 
password which applies to all libraries in the concatenation 
sequence. 



Link Access Mode 



The link access mode for update must be one of the following: 

W - Link will be successful only if no other user is currently 
accessing the minidisk (in either read or write mode). 

M - Link will be successful if no other user is currently 
accessing the minidisk in write mode. 

MW - Link will be successful in all cases. 

If the library is to reside on a user's A-disk (which SPF assumes 
has a virtual device address of 191), do not specify "MW" for the 
link access mode. SPF will not protect against multiple write 
accessing to virtual device 191. 

Note : As a general rule, multiple-write passwords should not be 
assigned to a user's A-disk. The absence of a such a password 
will prevent any attempt to link to the disk in "MW" mode. 

For SPF libraries which are not on a user's A-disk, a link access 
mode of "MW" may be specified provided that all access to that 
minidisk (for SPF libraries or any other files) is through SPF. 
If some accesses to the minidisk will be done outside SPF, a link 
access mode of "M" or "W" should be specified. 

SPF provides appropriate protection to guard against destructive 
contention in multiple read/write accessing of SPF libraries and 
CMS files, except as noted above for a user's A-disk. 



Unique Identifier 



The CMS filetype (for organization "S") or CMS filename (for 
organization "M" or "T") must uniquely identify which files on a 
minidisk belong to the SPF library. The recommended procedure is 
to let SPF assign a unique identifier by leaving the filetype and 
filename fields blank on the "specify" panel. The SPF-assigned 
identifier will be of the form: 

SPFnnnnc 

where "nnnn" is a four digit number, and "c" is S, M, or T. 
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Keep in mind the following points: 

• For an SPF library, the CMS filetype (organization "S") or 
filename (organization "M" or "T") need not conform to any CMS 
naming convention. 

• Since the SPF library can be referenced by project, library, 
and type on any panel, the CMS filetype or filename is genei — 
ally transparent to the user. 

If a filetype or filename is entered on the "specify" panel, it is 
the user's responsibility to ensure that the identifier is unique 
for the minidisk. If sequential files already exist on the mini- 
disk with the specified filetype, or if MACLIBs or TXTLIBs already 
exist on the minidisk with the specified filename, the existing 
files will automatically be included in the SPF library. This may 
or may not be desired. In any case, the SPF file utility will 
display a warning on the "confirm specify" panel that existing 
files will be included in the SPF library. 



PROCESSING CONSIDERATIONS 

SPF maintains information on all SPF libraries specified to the VM 
system. Whenever a user enters project, library, and type on a 
panel, SPF determines the minidisk on which the library is located 
(user id and virtual device address), and then performs the neces- 
sary LINK and ACCESS commands on behalf of the user. 

For the LINK command, SPF uses a link access mode of "RR" (for a 
read-only function such as browse), or whatever mode was entered 
when the library was specified (for an update function such as 
edit). Link access mode "RR" allows the LINK to occur even if 
another user has the disk accessed in read or write status. 

For the ACCESS command, SPF selects the first available mode let- 
ter (in the collating sequence) which is not currently in use by 
the user who is accessing the library. 

The minidisk containing the SPF library is automatically detached 
(and the mode letter is released) when the user finishes the 
selected SPF function. 

Under certain circumstances, the automatic LINK and ACCESS can 
cause a temporary alteration to the user's normal search sequence 
for CMS files. Example: 

Suppose the user has explicitly accessed two minidisks, using 
mode letters A and C. Subsequently, the user specifies an SPF 
library on some panel (such as browse). SPF selects mode let- 
ter B to access the library. The user then enters split 
screen mode (without leaving browse), and specifies a CMS 
filename and filetype on another panel. If the specified file 
exists on both the B and C disks (but not on A), the B copy 
will be found first. The user may not be expecting this, 
since he did not explicitly access the B-disk. 



Foreground/Batch Processing 

The SPF foreground and batch processing options (options 4 and 5) 
automatically perform the following operations if an SPF library 
(or concatenated sequence of libraries) is specified: 

• The library (or sequence of libraries) is scanned to find the 
specified member, and the member is copied to a temporary 
file, if required, with a CMS filetype which is acceptable to 
the particular processing program (e.g., ASSEMBLE, COBOL, 
PLI). The CMS filename for the temporary file will be the 
same as the SPF member name. 
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For any libraries in the SPF concatenation sequence (includ- 
ing the first* or only, library) which are not organization 
"M", temporary MACLIBs are created and all members are copied 
from each SPF library to the corresponding MACLIB. A GLOBAL 
command is then executed to set up the MACLIB concatenation 
sequence. This allows members to be included (via INCLUDE or 
COPY statements) from the concatenated sequence of libraries 
during the compilation or assembly. 

For foreground processing, the temporary file and temporary 
MACLIBs will reside on the the user's A-disk. For batch, they 
will reside on the batch machine's A-disk. In either case, 
the temporary files are erased once the compi lati on or assem- 
bly has completed. 

The TEXT (object) module produced by the compilation or 
assembly is placed in an SPF library with the following name: 

Project - same as project name of source library 

Library - same as first library in concatenation sequence 

Typo - TEXT 

For foreground processing, the TEXT module is automatically 
placed in the SPF TEXT library. For batch processing, the 
user may invoke the SPF reader utility (option 3.7) to cause 
the TEXT module to be inserted into the SPF TEXT library. 



SPF Library Statistics 



Whenever an SPF library is specified, a separate file is created 
on the same minidisk to contain the library statistics. This is a 
sequential file with a CMS filetype of SPFSTATS and a filename 
which is the same as the unique identifier of the SPF library. 

Generally, the SPFSTATS file is transparent to the user, since the 
statistics are automatically created and maintained by the SPF 
editor (if STATS mode is on), and automatically displayed on mem- 
ber selection lists and printed on "index" listings. 

Users should not attempt to edit or otherwise modify the SPFSTATS 
files. If an SPFSTATS file is modified or destroyed, however, only 
the statistics will be lost; the contents of the SPF library mem- 
bers will still be intact. 

If members of the SPF library are modified outside of SPF (via 
some other editor) or are specified on an SPF panel via CMS file 
id (rather than project, library, and type), the statistics will 
not be properly updated, but the information in the member will 
still be acceptable to SPF. 

Note : If a user deletes all lines in a member of an SPF library 
(using the SPF editor) and then saves the member, the statistics 
will show that the member still exists but has a length of zero. 
However, if the library is specified for a foreground or batch 
compilation or assembly, the member will not be found by the proc- 
essing program. The proper way to delete a member (including its 
statistics) is to use the library utility (option 3.1). 
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